backdrop-blur-egui 0.1.0

egui adapter for backdrop-blur: frosted glass over two paths sharing one Surface vocabulary — own-loop (egui-wgpu, render to an intermediate and composite) and grab-pass (eframe-on-glow, grab the live framebuffer in a paint callback, blur, composite).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! The feature-neutral spine: [`Surface`], the description of a frosted surface that **both**
//! adapter paths share. The own-loop path resolves it to a top-left [`BlurRequest`]
//! (`Surface::request`, gated `own-loop`); the grab-pass path reads its material fields directly
//! and builds a bottom-left request from a `GlRegion` at the egui callback. Keeping the type here
//! — not in either feature-gated module — is what lets a grab-pass-only (kiosk) build name a
//! `Surface` without compiling the wgpu stack.

use backdrop_blur_core::{BlurStrength, CornerRadius, Opacity, RepaintPolicy, Tint};

/// A frosted surface to composite this frame: an egui-space rectangle (logical points) plus the
/// glass parameters and a liveness policy. v1 treats the backdrop directly behind the rect as the
/// blur source (`source_region == target_rect`).
///
/// Fields are public so the grab-pass adapter can read the material (`strength`, `tint`,
/// `corner_radius`) straight off the surface inside the paint callback while deriving geometry
/// from the GL-origin region — the two paths share the *what* (this type) and differ only in the
/// *where* (top-left request vs bottom-left `GlRegion`).
#[derive(Clone, Copy, Debug)]
pub struct Surface {
    /// Where the surface sits, in egui logical points.
    pub rect: egui::Rect,
    /// How much blur.
    pub strength: BlurStrength,
    /// The glass film.
    pub tint: Tint,
    /// How round the corners are.
    pub corner_radius: CornerRadius,
    /// Surface-global fade `[0, 1]` — how present the whole surface is (default `1.0`). Drive this
    /// per frame to dissolve the frost in/out (e.g. a modal scrim fading with its dialog).
    pub opacity: Opacity,
    /// How often the backdrop must be refreshed (drives `request_repaint`).
    pub repaint: RepaintPolicy,
}