pub struct RunOutput {
pub snapshot: Vec<(String, u32, Option<SolidDisplay>)>,
pub report: SceneBuildReport,
pub provenance: Vec<(String, String)>,
pub entity_origin: Vec<(String, String)>,
pub assembly_poses: Vec<(String, Value)>,
pub assembly_fixed: Vec<(String, bool)>,
pub moved_solids: Vec<String>,
pub imported_colors: Vec<(String, String)>,
}Expand description
The delta a SceneRunner::run produces: the displayed KERNEL solids IN
ORDER plus the run’s SceneBuildReport. The applier walks snapshot in
order, reusing or replacing each entry (see the field docs).
Fields§
§snapshot: Vec<(String, u32, Option<SolidDisplay>)>The displayed KERNEL solids IN ORDER. display: Some = freshly tessellated
(new, or the handle changed since last emit); None = UNCHANGED — the
applier keeps its existing SolidDisplay for this name, whose
source_handle equals handle.
report: SceneBuildReport§provenance: Vec<(String, String)>Eager PROVENANCE: name -> creating-feature id for the run’s FINAL resident
SOLIDS (same last-writer-wins fold as the display snapshot). Shipped WITH the
run so the main thread can answer SOLID provenance without a cold
execute_history — critical once the run lives on a background thread and the
main-side registry is cold.
entity_origin: Vec<(String, String)>Eager ENTITY ORIGIN: face/edge NAME -> ORIGINATING feature id (FIRST writer
in timeline order, never pruned — see SceneLayout::entity_origin). Shipped
beside provenance so creating_feature can answer “which feature gave this
face/edge its name?” (the “Edit owning feature” context action + the Info
tab’s creatingFeature) with no cold re-run. Crosses the background-worker
seam, so the serde round-trip test asserts it survives.
assembly_poses: Vec<(String, Value)>Assembly-solver POSE write-backs from this run’s constraint tail:
(component feature id, {translate, rotateEulerDeg}) — read RUNNER-SIDE
(the kernel assembly session is thread-local to the thread/worker that ran
execute_history, so only the runner can see it) and shipped here so the
engine folds them into the owning ACOMP features’ inputParams (the
pose-authority contract, build-spec §6 step 4). Empty on a no-motion
solve — a satisfied assembly must not churn feature fingerprints.
#[serde(default)] keeps pre-assembly serialized replies deserializing.
assembly_fixed: Vec<(String, bool)>isFixed write-backs riding the same fold (the Fixed-constraint lane
grounds a component); shape mirrors Self::assembly_poses.
moved_solids: Vec<String>Names of solids the solve re-posed IN PLACE this run (the display seam:
their producing feature may have replayed reused, yet their geometry
moved). The runner already defeated the handle-unchanged reuse fast path
for these (their snapshot entries arrive Some, freshly tessellated);
shipped for observability/tests. Empty on zero-mate/no-motion runs.
imported_colors: Vec<(String, String)>IMPORTED COLOURS: entity name -> "#RRGGBB" for every solid/face this run
left a color scene-metadata record on (STEP presentation entities, read
by brep_kernel::io/appearance.rs and stamped by IMPORT3D).
Read RUNNER-SIDE for the same reason as assembly_poses: the kernel’s
scene-metadata store is thread-local to whoever ran execute_history, so
a main-thread read under a background runner sees nothing. The applier
folds these into the engine’s own crate::metadata::MetadataStore
WITHOUT overwriting, so the Info window shows an imported colour and a
user’s edit of it still wins.
Filtered to the names this run actually produced, so a colour left in the (never-cleared) kernel store by a previous document cannot bleed into this one.
Trait Implementations§
Source§impl<'de> Deserialize<'de> for RunOutput
impl<'de> Deserialize<'de> for RunOutput
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Auto Trait Implementations§
impl !RefUnwindSafe for RunOutput
impl !Sync for RunOutput
impl Freeze for RunOutput
impl Send for RunOutput
impl Unpin for RunOutput
impl UnsafeUnpin for RunOutput
impl UnwindSafe for RunOutput
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> DeserializeOwned for Twhere
T: for<'de> Deserialize<'de>,
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more