Struct ImageEmitter 

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

An image source weighted by alpha or linear luminance, inheriting pixel colors.

Implementations

impl ImageEmitter

pub fn new( image: Arc<ImageAsset>, bounds: Rect, density: ImageDensity, limits: SimulationLimits, ) -> Result<Self, ValidationError>

Prepares a CDF under logical budgets; zero-weight images fail explicitly.

impl ImageEmitter

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.

Trait Implementations

impl Clone for ImageEmitter

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 ImageEmitter

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.