Struct ParticleSystem 

pub struct ParticleSystem<const N: usize> { /* private fields */ }

Fixed-capacity particle system.

N is the maximum number of simultaneously live particles. Slots are reused in-place so spawning never allocates.

Implementations

impl<const N: usize> ParticleSystem<N>

pub fn new() -> Self

Create a new, empty system.

pub fn spawn(&mut self, s: ParticleSpawn) -> bool

Spawn a particle. Returns true on success, false if the pool is at capacity (N particles already live).

pub fn update(&mut self, dt: f32, gravity: Vector3<f32>)

Advance all particles by dt seconds.

gravity is applied uniformly to every particle’s velocity. Pass Vector3::zeros() to disable gravity for this system.

pub fn active_count(&self) -> usize

Number of currently live particles.

pub fn is_empty(&self) -> bool

true if no particles are live.

pub fn iter_active(&self) -> impl Iterator<Item = &Particle>

Iterate over live particles (read-only).

pub fn record<const MAX: usize>( &self, engine: &K3dengine, commands: &mut CommandBuffer<MAX>, ) -> usize

Record all live particles as camera-facing billboard quads into commands.

Each particle emits two DrawPrimitive::ColoredTriangleWithDepth commands. Billboard orientation uses world-up (0, 1, 0), which is correct for all but extreme pitch angles.

Returns the number of particles successfully projected and emitted. Particles that project behind the camera or outside the frustum are silently skipped.

Trait Implementations

impl<const N: usize> Default for ParticleSystem<N>

fn default() -> Self

Returns the “default value” for a type.