Struct ParticleSimulationBuilder 

pub struct ParticleSimulationBuilder { /* private fields */ }

Collects a particle simulation’s settings; build validates them.

Implementations

impl ParticleSimulationBuilder

pub fn style(self, style: ParticleStyle) -> Self

Sets presentation; it does not affect the physics snapshots.

impl ParticleSimulationBuilder

pub fn new(seed: u64) -> Self

Starts a simulation with an explicit deterministic seed.

pub fn duration(self, duration: Duration) -> Self

Sets finite preparation duration; otherwise render inherits clip duration.

pub fn step(self, step: Duration) -> Self

Sets an exact positive integer-tick step; no variable last integration step.

pub fn snapshot_interval(self, steps: u64) -> Self

Requests snapshot spacing; memory admission may increase it automatically.

pub fn limits(self, limits: SimulationLimits) -> Self

Replaces logical resource allowances.

pub fn emitter(self, emitter: impl ParticleEmitter + 'static) -> Self

Appends one fixed-boundary emitter, in declaration order.

pub fn modifier(self, modifier: impl ParticleModifier + 'static) -> Self

Appends one deterministic operator; ordering is significant.

pub fn group_modifier( self, modifier: impl ParticleGroupModifier + 'static, ) -> Self

Adds a population operator before independent particle updates.

pub fn sub_emitter(self, emitter: SubEmitter) -> Self

Adds a stable-order, bounded event emitter rule.

pub fn prewarm(self, duration: Duration) -> Self

Prepares a steady-state lead-in without changing the visible clip duration.

pub fn loop_period(self, period: Duration) -> Self

Enables deterministic dual-phase seamless looping; two live populations share the limit.

pub fn time_remap( self, scale: f64, offset: Duration, allow_reverse: bool, ) -> Self

Remaps query time. Negative scales require allow_reverse, which explicitly revives past particles.

pub fn workers(self, workers: usize) -> Self

Requests 1..=64 CPU workers; independent updates retain stable IDs and event order.

pub fn build(self) -> Result<ParticleSimulation, ValidationError>

Checks everything that does not depend on the clip duration and freezes the simulation. Duration-dependent limits are checked when it is first sampled.

Trait Implementations

impl Clone for ParticleSimulationBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.