backdrop-blur-core 0.1.0

Backend-agnostic seam, material/geometry vocabulary, and error model for backdrop blur (frosted glass). The one crate with no GPU dependency.
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
34
35
36
37
38
39
40
41
42
43
44

//! `backdrop-blur-core` — the backend-agnostic heart of [`backdrop-blur`].
//!
//! This crate owns the *vocabulary* of frosted glass and the *seam* every GPU backend
//! implements, and nothing else. It has **no GPU dependency**, is fully headless-testable,
//! and forbids `unsafe`. That makes it the one crate in the workspace that cannot break a
//! backend: the material/geometry types, the [`BlurError`] model, the liveness policy, and
//! the backdrop-blur seam trait all live here, while `wgpu`/`glow` resource types stay out.
//!
//! # The shape of a blur
//!
//! A caller describes a frosted surface with a [`BlurRequest`] — *where* the backdrop lives
//! and the surface goes ([`Region`]s in physical pixels), and *what kind of glass* it is
//! ([`BlurStrength`], [`Tint`], [`CornerRadius`]). Core resolves the algorithm-agnostic parts
//! (a physical blur radius via [`BlurRequest::physical_blur_radius`]; a clamped
//! [`ResolvedMask`]); the backend resolves the algorithm-specific parts (kernel offsets,
//! pipelines) and does the GPU work.
//!
//! See `docs/DESIGN.md` (§4 is the load-bearing type design) and `docs/IMPL.md` for the
//! rationale and build sequence.
//!
//! [`backdrop-blur`]: https://github.com/abdu-benayad/backdrop-blur
#![forbid(unsafe_code)]

mod algorithm;
mod error;
mod eviction;
mod geometry;
mod gl_region;
mod liveness;
mod material;
mod seam;

pub use algorithm::{
    GaussianKernel, KAWASE_THRESHOLD_PX, MAX_GAUSSIAN_RADIUS, MAX_KAWASE_LEVELS, PingPongKey,
    TargetEncoding, backdrop_uv_remap, kawase_halfpixel, kawase_level_size, resolve_gaussian,
    resolve_kawase_levels, use_dual_kawase,
};
pub use error::{BackendError, BlurError, BlurStage};
pub use eviction::{RETENTION_FRAMES, evict_decision};
pub use geometry::{BlurRequest, Region, ResolvedMask, Scale};
pub use gl_region::GlRegion;
pub use liveness::RepaintPolicy;
pub use material::{BlurStrength, CornerRadius, LinearRgba, Opacity, Tint};
pub use seam::{BackdropBlur, GrabPass};