Enum ParticleStyle 

pub enum ParticleStyle {
    Dots {
        radius: f64,
    },
    GlowDots {
        radius: f64,
    },
    Sprites {
        image: Handle<ImageAsset>,
        size: f64,
        align_to_velocity: bool,
    },
    Trails {
        length: Duration,
        width: f64,
    },
    Plexus {
        radius: f64,
        max_distance: f64,
    },
    Shape {
        radius: f64,
        shape: ParticleShape,
    },
    Bokeh {
        radius: f64,
        aperture: f32,
        focus: f32,
        shape: BokehShape,
        ring: f32,
        hardness: f32,
        highlight: f32,
    },
    Configured {
        style: Box<ParticleStyle>,
        options: StyleOptions,
    },
    Custom(Arc<dyn Fn(&[Particle], &SceneContext<'_>) -> Result<Node, ValidationError> + Send + Sync>),
}

particle presentation. Built-ins share an instance protocol; custom callbacks run on CPU and return ordinary content or a validation error, never custom WGSL.

Variants

Dots

Smooth analytic circles; radius multiplies particle.size.

Fields

radius: f64

Base local radius.

GlowDots

Compact Gaussian halos with linear Plus compositing.

Fields

radius: f64

Gaussian scale (support extends to three radii).

Sprites

Bilinear sprite instances, tinted by premultiplied particle color.

Fields

image: Handle<ImageAsset>

Lazy immutable texture.

size: f64

Full local sprite side.

align_to_velocity: bool

Adds velocity direction to particle.rotation.

Trails

Eight actual historical segments per particle, not a velocity extrapolation.

Fields

length: Duration

Historical interval.

width: f64

Local line width.

Plexus

Analytic dots and bounded pairwise neighbor connections.

Fields

radius: f64

Dot radius.

max_distance: f64

Maximum local neighbor separation.

Shape

Texture-free analytic geometry.

Fields

radius: f64

Base radius or half height.

shape: ParticleShape

Coverage geometry.

Bokeh

Depth-aware, energy-compensated aperture. Depth is particle.custom[1].

Fields

radius: f64

Base in-focus radius.

aperture: f32

Circle-of-confusion scale.

focus: f32

In-focus depth.

shape: BokehShape

Aperture silhouette.

ring: f32

Rim intensity in 0..=1.

hardness: f32

Edge hardness in 0..=1.

highlight: f32

Finite nonnegative HDR multiplier.

Configured

A built-in or custom style with explicit batch options; see StyleOptions.

Fields

style: Box<ParticleStyle>

Underlying built-in or custom style.

options: StyleOptions

Batch-level presentation policy.

Custom(Arc<dyn Fn(&[Particle], &SceneContext<'_>) -> Result<Node, ValidationError> + Send + Sync>)

CPU-only presentation callback.

Implementations

impl ParticleStyle

pub fn blend(self, blend: ParticleBlend) -> Self

Selects compositing for the entire batch, not individual GPU invocations.

pub fn sheet(self, sheet: SpriteSheet) -> Self

Adds animation or atlas UVs to Sprites.

pub fn trails(self, trails: TrailOptions) -> Self

Configures segment count, endpoint width/color and optional smoothing/ribbon.

pub fn stretch_by_speed(self, scale: f32, maximum: f32) -> Self

Aligns and stretches geometry along the velocity, with a finite ceiling.

pub fn parallax(self, offset: [f32; 2]) -> Self

Adds deterministic depth parallax and stable depth ordering.

pub fn flip(self) -> Self

Enables the analytic single-axis confetti flip.

Trait Implementations

impl Clone for ParticleStyle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ParticleStyle

fn default() -> Self

Returns the “default value” for a type.