Struct ParticleSimulation 

pub struct ParticleSimulation { /* private fields */ }

Lazy fixed-step replay, created by ParticleSimulationBuilder::build. The first clip duration fixes a shared preparation; reusing one cache instance with a different duration is rejected explicitly. The configuration never changes after building.

Implementations

impl ParticleSimulation

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) -> ParticleSimulationBuilder

Starts a lazy fixed-step simulation with an explicit deterministic seed. Cache the built value with SceneContext::try_cache rather than building one afresh for every frame.

impl ParticleSimulation

pub fn to_builder(&self) -> ParticleSimulationBuilder

Reopens the settings for editing; the new simulation prepares afresh.

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 with_duration(self, duration: Duration) -> WithDuration<Self>

where Self: Sized,

Overrides clip metadata without retiming or clamping the callback.