Struct SimThread 

pub struct SimThread { /* private fields */ }

Handle on a running CPU simulation.

The sim runs on its own thread on native targets. In a browser Self::update steps it from the host’s frame loop.

Implementations

impl SimThread

pub fn new( state: Box<dyn SimState>, target_tps: f64, wake: Option<WakeFn>, faults: FaultSink, ) -> Self

Starts a paused runner over state, capped at target_tps ticks per second.

wake is None only for a headless caller that polls on its own schedule.

A panic out of the loop is stored in faults. The GPU runner reads the same sink off its GpuContext.

pub fn send(&mut self, cmd: SimCommand)

Sends a command to the loop.

pub fn take_snapshot(&mut self) -> Option<Snapshot>

Takes the latest snapshot, or None when nothing new has been published since the last take.

pub fn recycle(&mut self, snap: Snapshot)

Stores a taken snapshot as the spare for the next publish to refill.

This is only an optimisation. Dropping the snapshot instead only means the next publish allocates.

pub fn play(&mut self)

Sends SimCommand::Play.

pub fn pause(&mut self)

Sends SimCommand::Pause.

pub fn step_once(&mut self)

Sends SimCommand::StepOnce.

pub fn set_schedule(&mut self, schedule: Schedule)

Sends SimCommand::SetSchedule.

pub fn run_to(&mut self, tick: u64)

Sends SimCommand::RunTo.

pub fn update(&mut self, dt: f64)

Advances the sim when the driver runs inside the frame loop, and does nothing when the driver has its own thread.

Trait Implementations

impl Debug for SimThread

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for SimThread

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.