haze/dev.chrisbanes.haze/HazeInput/Backdrop

Backdrop

data class Backdrop(val fallback: HazeInput.Sources?) : HazeInput

The intent to consume pixels already drawn behind the effect in the current window.

This is the normal portable input for built-in effects. When HazeFeatureFlags.isPlatformBackdropEnabled is enabled before attachment, the native path is eligible on supported Android releases and for built-in effects that expose a compatible platform effect. Eligibility is not a guarantee: the fallback options are used everywhere else and after any native setup or draw failure. Native backdrop rendering samples earlier pixels in the same window; it does not select individual source instances, include later drawing, or sample content from another window.

The experimental flag defaults to false and is read when the modifier node attaches. Changing it affects later attachments only. A native-to-source fallback transition can take one frame and remains selected until detachment after a known native failure.

Constructors

Backdrop

constructor(fallback: HazeInput.Sources?)

constructor(state: HazeState? = null)

Creates a backdrop input with the default source fallback for state, when provided.

Properties

fallback

val fallback: HazeInput.Sources?

Optional source input used only when the native backdrop is unavailable or fails. A null fallback leaves the content unchanged when native backdrop rendering is not available. It does not filter native window pixels.