Enum Backdrop 

pub enum Backdrop {
    Opaque,
    Transparent,
    Blur,
    Tinted,
}

What shows through a window where its frame paints nothing, or paints with alpha (backlog F126): named for the effect, not for where an app uses it. The app decides which regions show it — a sidebar, a toolbar — by painting them with alpha and the rest opaque; kui knows nothing of sidebars.

Asked for by the app (kui_native::Launcher::backdrop) and reported back, as what the driver actually got, in WindowEnv::backdrop — a platform that cannot give the effect reads what it gave instead, down to Opaque, and a view that paints translucent regions paints them opaque there.

use kui_core::Backdrop;

assert_eq!(Backdrop::default(), Backdrop::Opaque);
assert_eq!(Backdrop::from_name("blur"), Some(Backdrop::Blur));
assert!(Backdrop::Tinted.is_translucent() && !Backdrop::Opaque.is_translucent());

Variants

Opaque

The window is opaque: what every window is unless an app asks.

Transparent

See-through where the frame is: the desktop and the windows under this one show as they are, unblurred. A compositor that blurs translucent windows itself (Hyprland, SwayFX, picom when configured) makes this look like Blur.

Blur

A live blur of whatever is behind the window, other windows included: macOS’s behind-window vibrancy (an NSVisualEffectView), Windows 11’s Acrylic, and on Linux the compositor’s blur where it offers one (KWin’s org_kde_kwin_blur or _KDE_NET_WM_BLUR_BEHIND_REGION, ext-background-effect-v1).

Tinted

The desktop’s colour, cheap and steady rather than live: Windows 11’s Mica, macOS’s window-background material (the wallpaper tinting AppKit gives a window), and elsewhere the wallpaper itself, read, scaled down and blurred once, drawn as the window’s ground.

Implementations

impl Backdrop

pub const ALL: [Backdrop; 4]

Every backdrop, in wire order: the index C’s KUI_BACKDROP_* spells. Append-only.

pub fn name(self) -> &'static str

The wire name, for the bindings and the report.

pub fn from_name(name: &str) -> Option<Backdrop>

The backdrop a wire name spells: the inverse of Self::name.

pub fn from_code(code: u32) -> Option<Backdrop>

The backdrop at C’s index, None past the end.

pub fn is_translucent(self) -> bool

Whether anything shows through: everything but Opaque.

Trait Implementations

impl Clone for Backdrop

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Backdrop

impl Debug for Backdrop

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Backdrop

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Backdrop

impl Hash for Backdrop

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Backdrop

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Backdrop