Expand description
Mathematical particle system.
Particles are driven by MathFunctions, not simple velocity/gravity. This creates particles that move in mathematically meaningful ways. Includes emitters, forces, trails, sub-emitters, collision, GPU data export.
Modules§
- emitters
- Preset emitter implementations.
- flock
- Full boid/flocking simulation with obstacle avoidance, leader following, and predator flee.
- gpu_
particles - GPU particle system — compute shader driven, double-buffered, indirect draw.
- particle_
render - GPU particle rendering bridge — renders particles directly from compute SSBO using indirect draw, with zero CPU readback.
Structs§
- Burst
Event - A one-shot burst event within a continuous emitter.
- Color
Gradient - A color gradient over normalized lifetime [0,1].
- Continuous
Emitter - Emitter that fires continuously at a given rate.
- FastRng
- Xoshiro-style fast RNG for particle systems.
- Float
Curve - A float keyframe curve for particle properties over normalized lifetime [0,1].
- GpuParticle
Instance - GPU-compatible instanced particle data: position + size + color (10 floats).
- LodParticle
System - A multi-LOD particle system that reduces fidelity based on camera distance.
- Math
Particle - An individual math-driven particle.
- Particle
Effect - A named, reusable particle effect that combines template + shape + forces.
- Particle
Flags - Bitfield of particle feature flags.
- Particle
Group - A named group of particles with shared behavior modifiers.
- Particle
Library - Registry of named particle effects.
- Particle
Pool - Pre-allocated pool of particles.
- Particle
System - A self-contained particle system with its own pool, forces, and emitters.
- Particle
System Stats - System-wide particle statistics.
- Particle
Template - A reusable template for spawning particles from an emitter.
- Pool
Stats - Runtime stats for the particle pool.
- Range
Param - A min/max range parameter that returns a random value when sampled.
- Scale
Curve - A scale-over-life curve: (time, scale_x, scale_y).
- SubEmitter
Ref - Reference to a sub-emitter that spawns on particle death.
- Trail
Ribbon - Computed trail ribbon geometry for a single particle.
Enums§
- Emitter
Preset - Preset emitter configurations for common game events.
- Emitter
Shape - Defines the 3-D region from which a burst emits.
- Particle
Force - A standalone particle force that can be added to a system.
- Particle
Interaction - How a particle interacts with other nearby particles.
Functions§
- emit
- Spawn particles from a preset into a pool.
- export_
gpu_ instances