Struct ParticleSimulation 

pub struct ParticleSimulation { /* private fields */ }

Lazy fixed-step replay. The first clip duration fixes a shared preparation; reusing one cache instance with a different duration is rejected explicitly. Mutating any builder setting creates a fresh preparation identity.

Implementations

impl ParticleSimulation

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

Replaces presentation without invalidating the immutable physics snapshots.

pub fn try_render( &self, context: &SceneContext<'_>, ) -> Result<Node, ValidationError>

Renders through the instance protocol using explicit clip metadata.

impl ParticleSimulation

pub fn new(seed: u64) -> Self

Creates a lazy fixed-step simulation with an explicit deterministic seed. Cache the result in SceneContext::cache rather than constructing one afresh for every frame.

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 sample(&self, time: Time) -> Result<Arc<[Particle]>, ValidationError>

Queries at the containing fixed boundary, never integrating a variable remainder. Outside [0,duration) is empty. Source initialization is shared.

pub fn sample_in( &self, time: Time, clip_duration: Option<Duration>, ) -> Result<Arc<[Particle]>, ValidationError>

Queries using explicit finite clip metadata when no duration was configured.

pub fn stats(&self) -> Result<SimulationStats, ValidationError>

Returns preparation stats without evaluating a rendered frame.

pub fn events(&self, time: Time) -> Result<Vec<ParticleEvent>, ValidationError>

Returns events at the containing fixed boundary, sorted by stable ID and trigger kind.

Trait Implementations

impl Clone for ParticleSimulation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Scene for ParticleSimulation

fn render(&self, context: &SceneContext<'_>) -> Node

Builds one snapshot without retaining previous-frame state.

fn duration(&self) -> Option<Duration>

Natural finite duration, or None when a caller must provide one.

fn validate(&self) -> Result<(), Error>

Validates deferred authoring errors without evaluating a frame.

fn audio_clips(&self) -> Result<Vec<AudioClip>, Error>

Returns pure audio metadata for precomposition/export, not playback. Default scenes are silent; callers must preserve local clip coordinates.

fn audio_composition(&self) -> Option<&Timeline>

Optional nested timeline ownership, preserved when its audio is relocated.

fn with_duration(self, duration: Time) -> WithDuration<Self>

where Self: Sized,

Overrides clip metadata without retiming or clamping the callback.