Struct SceneRunner 

pub struct SceneRunner { /* private fields */ }

A stateful, SCENE-FREE history run that emits a DELTA snapshot instead of mutating a scene — the M1 seam of the off-thread history runner. It remembers, in Self::last_sent, the resident handle it last EMITTED per solid name, so a rerun can tell the applier which displays are UNCHANGED (skip re-tessellating

• keep their GPU buffers) vs. which are new/rebound (freshly tessellated).

Being scene-free is the point: a later milestone runs this on a background thread / worker with no access to the render scene, then ships the RunOutput delta back to the main thread to apply. In M1 the run is immediately applied on the same thread (see EngineState::apply_run_output), so behavior is byte-identical to the pre-seam in-place reconcile.

Implementations

impl SceneRunner

pub fn new() -> Self

pub fn reset(&mut self)

Reset the delta baseline (call on a wholesale document switch so the next run is a full rebuild — no stale reuse across unrelated models).

pub fn run( &mut self, request: &HistoryRequest, color_overrides: Option<&HashMap<String, [f32; 3]>>, ) -> RunOutput

Execute request and fold it into an ordered delta snapshot (does NOT touch any scene). For each displayed kernel solid in order: if the handle is unchanged since the last emit, emit (name, handle, None) (the applier keeps its existing display); otherwise (re-)tessellate the resident handle and emit (name, handle, Some(display)). A display-payload error is recorded in report.display_errors and the entry is SKIPPED — and NOT recorded in the new baseline, so a later successful run re-tessellates it.

color_overrides is an optional name → sRGB [0..1;3] map (the metadata color layer); applied to freshly built solids only (reused ones keep it).

pub fn handle_of(&self, name: &str) -> Option<u32>

The resident handle last EMITTED for name (the delta baseline), or None if the runner has not emitted a solid of that name. The measurement-query path resolves an object’s owning-solid handle through this so the query runs against the SAME resident geometry the last run displayed (on the runner’s own thread, whose registry is warm from that run).

Trait Implementations

impl Default for SceneRunner

fn default() -> Self

Returns the “default value” for a type.