Struct IsolatedEffects

pub struct IsolatedEffects {
    pub opacity: f32,
    pub blur_radius_px: f32,
    pub backdrop_blur_radius_px: f32,
    pub blend_mode: BlendMode,
}

Post-effects applied to an isolated offscreen pass before compositing.

Values are stored without clamping. Render backends decide how to handle opacity outside 0.0..=1.0, non-finite values, and blur radii larger than their resource limits. Self::is_noop uses an opacity tolerance of 0.001 and treats non-positive blur radii as disabled.

Examples

use ailloli_ui_runtime::{BlendMode, IsolatedEffects};
let effects = IsolatedEffects::default();
assert_eq!(effects.opacity, 1.0);
assert_eq!(effects.blend_mode, BlendMode::Normal);
assert!(effects.is_noop());

Fields

opacity: f32

Group opacity multiplier (1.0 = opaque group).

blur_radius_px: f32

Gaussian-ish blur radius in physical pixels (0.0 = disabled) on layer content.

backdrop_blur_radius_px: f32

Blur of content already rendered behind this layer (backdrop filter backdrop).

blend_mode: BlendMode

Blend operation used when recombining the isolated pass.

Implementations

impl IsolatedEffects

Provides the operations defined for IsolatedEffects.

pub fn is_noop(&self) -> bool

No offscreen pass required: render in the main single pass.

This returns true exactly when opacity is at least 0.999, both blur radii are at most zero, and blend mode is BlendMode::Normal. Thus opacity above one and negative blur values are still considered no-op; NaN in any numeric field forces false through ordered comparisons.

Examples

use ailloli_ui_runtime::IsolatedEffects;
let mut effects = IsolatedEffects::default();
effects.opacity = 0.998;
assert!(!effects.is_noop());
effects.opacity = 1.0;
effects.blur_radius_px = -1.0;
assert!(effects.is_noop());

pub fn needs_offscreen(&self) -> bool

Whether this layer must be rendered to an offscreen target.

This is exactly the negation of Self::is_noop; it does not check backend support or allocate a target.

Examples

use ailloli_ui_runtime::{BlendMode, IsolatedEffects};
let effects = IsolatedEffects { blend_mode: BlendMode::Multiply, ..IsolatedEffects::default() };
assert!(effects.needs_offscreen());

Trait Implementations

impl Clone for IsolatedEffects

fn clone(&self) -> IsolatedEffects

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IsolatedEffects

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

Formats the value using the given formatter.

impl Default for IsolatedEffects

Implements the Default contract for IsolatedEffects.

fn default() -> Self

Constructs the documented default value.

impl PartialEq for IsolatedEffects

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for IsolatedEffects

impl StructuralPartialEq for IsolatedEffects