Struct GpuParticleSystem 

pub struct GpuParticleSystem {

    pub max_particles: u32,
    pub alive_count_approx: u32,
    pub current_read: u32,
    pub corruption: f32,
    pub force_fields: Vec<GpuForceField>,
    pub pending_emits: Vec<GpuEmitterConfig>,
    pub initialized: bool,
    pub distribution: EngineDistribution,
    pub depth_layers: Vec<f32>,
    pub damping: f32,
    pub gravity: Vec3,
    pub wind: Vec3,
    pub turbulence: f32,
}

The main GPU particle system.

Manages double-buffered SSBOs, compute shader dispatches, and indirect rendering. All particle simulation happens on the GPU — the CPU only uploads uniform parameters (force fields, corruption, time).

Fields

max_particles: u32

Maximum number of particles the system supports.

alive_count_approx: u32

Currently alive particle count (approximate — GPU-authoritative).

current_read: u32

Which buffer is the current read source (A=0, B=1).

corruption: f32

Corruption parameter (0.0 = normal, affects engine behaviors).

force_fields: Vec<GpuForceField>

Active force fields.

pending_emits: Vec<GpuEmitterConfig>

Pending emitter configs for this frame.

initialized: bool

Whether the system has been initialized with initial particles.

distribution: EngineDistribution

Per-engine particle counts for initial seeding.

depth_layers: Vec<f32>

Depth layer assignments: how many layers and their Z offsets.

damping: f32

Global damping factor.

gravity: Vec3

Gravity vector.

wind: Vec3

Wind vector.

turbulence: f32

Turbulence strength.

Implementations

impl GpuParticleSystem

pub fn new(max_particles: u32) -> Self

Create a new GPU particle system.

pub fn chaos_field() -> Self

Create a chaos field system with default 50,000 particles across 3 depth layers.

pub fn chaos_field_large() -> Self

Create a large chaos field with 131,072 particles.

pub fn generate_initial_particles(&self, bounds: Vec3) -> Vec<GpuParticle>

Generate initial particle data for CPU upload.

This creates a buffer of max_particles particles distributed according to self.distribution, positioned randomly within a bounding volume.

pub fn add_force_field(&mut self, field: GpuForceField)

Add a force field for this frame.

pub fn add_impact_field(&mut self, position: Vec3, strength: f32, radius: f32)

Add a temporary impact force field (e.g., from a combat hit).

pub fn add_vortex_field(&mut self, position: Vec3, strength: f32, radius: f32)

Add a vortex force field.

pub fn add_repulsion_field( &mut self, position: Vec3, strength: f32, radius: f32, )

Add a repulsion field (explosion shockwave).

pub fn emit(&mut self, config: GpuEmitterConfig)

Queue particles for emission this frame.

pub fn emit_burst( &mut self, origin: Vec3, count: u32, engine_type: u32, color: Vec4, )

Queue a burst of particles with a specific engine type.

pub fn clear_frame_state(&mut self)

Clear all force fields. Call at the start of each frame.

pub fn swap_buffers(&mut self)

Swap read/write buffers after compute dispatch.

pub fn update_dispatch_params(&self) -> GpuParticleDispatchParams

Get the compute dispatch parameters for the update pass.

pub fn indirect_draw_params(&self) -> GpuIndirectDrawParams

Get the indirect draw parameters.

Trait Implementations

impl Default for GpuParticleSystem

fn default() -> Self

Returns the “default value” for a type.