Enum Emitter 

pub enum Emitter {
    Point {
        position: Vec3,
        rate: f32,
        speed: f32,
    },
    Burst {
        position: Vec3,
        count: u32,
        speed: f32,
    },
    Cone {
        position: Vec3,
        direction: Vec3,
        speed: f32,
        spread: f32,
        rate: f32,
    },
    Sphere {
        center: Vec3,
        radius: f32,
        speed: f32,
        rate: f32,
    },
    Box {
        min: Vec3,
        max: Vec3,
        velocity: Vec3,
        rate: f32,
    },
}

Particle emitter configuration.

Emitters respawn dead particles at a configurable rate. They run as part of the compute shader, finding dead particle slots and reinitializing them.

Example

Simulation::<Spark>::new()
    .with_particle_count(10_000)
    .with_emitter(Emitter::Point {
        position: Vec3::ZERO,
        rate: 500.0,
    })
    .with_rule(Rule::Age)
    .with_rule(Rule::Lifetime(2.0))
    .with_rule(Rule::Gravity(9.8))
    .run();

Variants

Point

Emit particles from a single point with random directions.

Simple omnidirectional emitter - particles fly out in all directions.

Fields

• position - Spawn location
• rate - Particles per second
• speed - Initial speed of particles (default behavior if 0: random 0-0.5)

Fields

position: Vec3

Spawn position.

rate: f32

Emission rate (particles per second).

speed: f32

Initial speed of particles. If 0, uses random velocity.

Burst

One-time burst of particles (explosion effect).

Spawns count particles in a single frame, then stops. Useful for explosions, impacts, or other instantaneous effects.

Fields

• position - Explosion center
• count - Number of particles to spawn
• speed - Initial outward speed
• triggered - Set to true to fire (resets after burst)

Fields

position: Vec3

Explosion center.

count: u32

Number of particles to spawn.

speed: f32

Initial outward speed.

Cone

Directional cone emitter.

Emits particles in a cone shape, useful for fountains, jets, thrusters.

Fields

• position - Spawn location
• direction - Primary emission direction (will be normalized)
• speed - Initial particle speed
• spread - Cone half-angle in radians (0 = laser, PI/2 = hemisphere)
• rate - Particles per second

Fields

position: Vec3

Spawn position.

direction: Vec3

Primary emission direction.

speed: f32

Initial speed of particles.

spread: f32

Cone half-angle in radians.

rate: f32

Emission rate (particles per second).

Sphere

Spawn particles on a sphere surface.

Particles spawn on the surface and move outward (or inward if speed < 0).

Fields

• center - Sphere center
• radius - Sphere radius
• speed - Outward speed (negative = inward)
• rate - Particles per second

Fields

center: Vec3

Sphere center.

radius: f32

Sphere radius.

speed: f32

Outward speed (negative for inward).

rate: f32

Emission rate (particles per second).

Box

Spawn particles within a box volume.

Particles spawn at random positions within the box with optional initial velocity.

Fields

• min - Minimum corner of the box
• max - Maximum corner of the box
• velocity - Initial velocity for all spawned particles
• rate - Particles per second

Fields

min: Vec3

Minimum corner of the box.

max: Vec3

Maximum corner of the box.

velocity: Vec3

Initial velocity.

rate: f32

Emission rate (particles per second).

Implementations

impl Emitter

pub fn rate(&self) -> f32

Get the emission rate in particles per second.

For Burst emitters, returns the count as a one-time rate.

Trait Implementations

impl Clone for Emitter

fn clone(&self) -> Emitter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Emitter

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

Formats the value using the given formatter.