Enum RenderEffect 

pub enum RenderEffect {
    Blur {
        radius_x: f32,
        radius_y: f32,
        edge_treatment: TileMode,
    },
    Offset {
        offset_x: f32,
        offset_y: f32,
    },
    Shader {
        shader: Arc<RuntimeShader>,
    },
    Chain {
        first: Arc<RenderEffect>,
        second: Arc<RenderEffect>,
    },
}

A render effect applied to a graphics layer’s rendered content.

Matches Jetpack Compose’s RenderEffect sealed class hierarchy, extended with Shader for custom WGSL effects.

Variants

Blur

Gaussian blur applied to the layer’s rendered content.

Fields

radius_x: f32

radius_y: f32

edge_treatment: TileMode

Offset

Offset the rendered content by a fixed amount.

Fields

offset_x: f32

offset_y: f32

Shader

Apply a custom WGSL shader effect.

Fields

shader: Arc<RuntimeShader>

Shared shader configuration; use Arc::make_mut to edit a cloned effect independently.

Chain

Chain two effects: apply first, then apply second to the result.

Child effects are shared; use Arc::make_mut to edit a cloned chain independently.

Fields

first: Arc<RenderEffect>

second: Arc<RenderEffect>

Implementations

impl RenderEffect

pub fn placeholder(&self) -> Option<ShaderPlaceholder>

What the effect draws while its pipelines compile: the placeholder of the shader that draws last, if it has one.

pub fn blur(radius: f32) -> RenderEffect

Create a blur effect with equal radius in both directions.

pub fn blur_with_edge_treatment( radius: f32, edge_treatment: TileMode, ) -> RenderEffect

Create a blur effect with equal radius in both directions and explicit edge treatment semantics.

pub fn blur_xy( radius_x: f32, radius_y: f32, edge_treatment: TileMode, ) -> RenderEffect

Create a blur effect with separate horizontal and vertical radii.

pub fn offset(offset_x: f32, offset_y: f32) -> RenderEffect

Create an offset effect.

pub fn runtime_shader(shader: RuntimeShader) -> RenderEffect

Create a custom shader effect from a RuntimeShader.

pub fn then(self, other: RenderEffect) -> RenderEffect

Chain this effect with another: self is applied first, then other.

pub fn contains_runtime_shader(&self) -> bool

Returns true if this effect or any chained sub-effect is a RuntimeShader. Animated shaders produce different output every frame, so layer surface caching is counterproductive for them.

pub fn preserves_transparency(&self) -> bool

Whether the effect returns zero over a transparent input: a blur or an offset of nothing is nothing, a shader when it declares so, and a chain when every step does.

pub fn input_padding(&self) -> f32

Maximum logical-pixel input padding required by this effect.

pub fn output_padding(&self) -> f32

Maximum logical-pixel distance this effect WRITES outside its rect. Only runtime shaders may declare one (SDF coverage past node bounds); blur/offset stay confined to their tight rect.

pub fn output_support(&self) -> Option<Rect>

The rect outside which this effect writes nothing, in its logical space with the origin at its rect’s top-left, when the stage that produces its output declared one; blur and offset write their whole rect and declare none.

pub fn sample_domain(&self) -> Option<Rect>

The rect outside which the stage that produces this effect’s output never samples what it is given, when it declared one; the whole input otherwise. A blur samples everything it writes and more.

Trait Implementations

impl Clone for RenderEffect

fn clone(&self) -> RenderEffect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RenderEffect

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

Formats the value using the given formatter.

impl PartialEq for RenderEffect

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

Equality operator ==.

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

Inequality operator !=.

impl RenderHash for RenderEffect

fn render_hash(&self) -> u64

impl StructuralPartialEq for RenderEffect