Struct SurfaceEmitter 

pub struct SurfaceEmitter(/* private fields */);

An area-uniform shared VectorSurface source.

Implementations

impl SurfaceEmitter

pub fn rate(self, rate: f64) -> Self

Replaces particles/second; constant schedules quantize to step boundaries.

pub fn rate_animation(self, rate: impl Animation<f64> + 'static) -> Self

Uses seeded stochastic fractional births at each fixed step; its expected birth count follows the animation, without hidden cursors.

pub fn lifetime(self, lifetime: Duration) -> Self

Replaces half-open particle lifetime.

pub fn speed(self, speed: f64) -> Self

Replaces isotropic launch speed (path sources use path tangents).

pub fn velocity(self, velocity: Vector2) -> Self

Adds a fixed design-unit velocity to the sampled launch direction.

pub fn color(self, color: [f32; 4]) -> Self

Sets finite premultiplied birth color.

pub fn size(self, size: f32) -> Self

Sets birth size in 0..=4096.

pub fn depth_range(self, minimum: f32, maximum: f32) -> Self

Samples depth into custom[1]; a constant range consumes no random draw.

pub fn paint(self, paint: Paint, bounds: Rect) -> Result<Self, ValidationError>

Multiplies the birth color by a solid or gradient paint evaluated at the sampled emission point; bounds is the paint’s objectBoundingBox. Consumes no random draws, so positions and timing are unchanged.

pub fn palette(self, colors: Arc<[[f32; 4]]>) -> Self

Selects a bounded deterministic premultiplied birth palette.

impl SurfaceEmitter

pub fn new(tree: Arc<VectorTree>) -> Self

Captures a shared tree; its default area triangulation is cached.

pub fn inherit_color(self, enabled: bool) -> Self

Enables fill-color inheritance without changing area density or sampled positions.

pub fn from_text( text: &Text, context: &DrawContext, ) -> Result<Self, ValidationError>

Captures already-shaped glyph outlines through the shared vector surface.

Trait Implementations

impl Clone for SurfaceEmitter

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ParticleEmitter for SurfaceEmitter

fn emit( &self, step: u64, time: Time, random: &mut Random, output: &mut Vec<Particle>, ) -> Result<(), ValidationError>

Appends births at this exact fixed-step boundary.

fn accepts_event(&self, _: &ParticleEvent) -> bool

Filters event-triggered births. Root emission is unaffected; ordinary emitters accept all events.