pub struct ExtractedFrame { /* private fields */ }Expand description
Complete renderer-independent visual snapshot for one World generation.
A snapshot is published only after every required visual and its CPU/Scene
limits have been validated. The desktop bridge must compare
ExtractedFrame::world_generation with the active World immediately
before submission so a retired generation is never rendered.
Implementations§
Source§impl ExtractedFrame
impl ExtractedFrame
Sourcepub const fn screen_extraction_updates(&self) -> ScreenExtractionUpdates
pub const fn screen_extraction_updates(&self) -> ScreenExtractionUpdates
CPU screen work for this snapshot, independent of native GPU preparation. Complete-frame publication uses two alternating buffers; each warms its own exact-value cache. World geometry/interpolation are not cached here.
Sourcepub const fn world_generation(&self) -> WorldGeneration
pub const fn world_generation(&self) -> WorldGeneration
Returns the World generation from which this snapshot was extracted.
Sourcepub const fn background(&self) -> Color
pub const fn background(&self) -> Color
Returns the normalized clear color for the composed frame.
Sourcepub const fn camera(&self) -> Camera2d
pub const fn camera(&self) -> Camera2d
Returns the validated, interpolated presentation camera for this frame.
This may differ from the active component’s canonical camera during a partial fixed interval.
Sourcepub fn resolved_circles(&self) -> &[ResolvedCircle]
pub fn resolved_circles(&self) -> &[ResolvedCircle]
Returns value-comparable circles in their relative mixed-scene order.
Sourcepub fn resolved_rectangles(&self) -> &[ResolvedRectangle]
pub fn resolved_rectangles(&self) -> &[ResolvedRectangle]
Returns value-comparable rectangles in their relative mixed-scene order.
Sourcepub fn resolved_lines(&self) -> &[ResolvedLine]
pub fn resolved_lines(&self) -> &[ResolvedLine]
Returns nonzero lines in their relative mixed-scene order.
Sourcepub fn resolved_screen_rectangles(&self) -> &[ResolvedScreenRectangle]
pub fn resolved_screen_rectangles(&self) -> &[ResolvedScreenRectangle]
Returns screen rectangles in their deterministic screen-layer order.
Positions and sizes are current logical pixels, not interpolated world coordinates. All these records are composed above the world scene.
Sourcepub fn screen_primitives(
&self,
) -> impl Iterator<Item = ResolvedScreenPrimitive> + '_
pub fn screen_primitives( &self, ) -> impl Iterator<Item = ResolvedScreenPrimitive> + '_
Iterates over sorted screen rectangles, lines, circles and paths without allocating. Path clones share their immutable CPU points. Values are current FrameUpdate presentation, independent of fixed interpolation.
Sourcepub fn resolved_screen_images(&self) -> &[ResolvedScreenImage]
pub fn resolved_screen_images(&self) -> &[ResolvedScreenImage]
Returns current screen images in their relative mixed-screen order.
Records contain immutable asset IDs, not GPU resources. Use
HeadlessRunner::image_asset to inspect the registered source pixels.
Sourcepub fn resolved_screen_texts(&self) -> &[ResolvedScreenText]
pub fn resolved_screen_texts(&self) -> &[ResolvedScreenText]
Returns current prepared labels in their relative mixed-screen order.
Strings, metrics, and fonts share their component’s immutable CPU preparation. No shaping, GPU allocation, or fixed interpolation occurs.
Sourcepub fn three_d(&self) -> Option<ThreeDSnapshot<'_>>
pub fn three_d(&self) -> Option<ThreeDSnapshot<'_>>
Returns the enabled 3D view and cuboids, or None when 3D is suppressed.
Desktop composition places this opaque depth target above the 2D world and below all screen draws. The snapshot contains no GPU resources.
Sourcepub fn resolved_cuboids(&self) -> &[ResolvedCuboid3d]
pub fn resolved_cuboids(&self) -> &[ResolvedCuboid3d]
Returns current visible cuboids in stable managed-identity order.
Missing or disabled View3d resources produce an empty slice.
Sourcepub fn resolved_meshes(&self) -> &[ResolvedMesh3d]
pub fn resolved_meshes(&self) -> &[ResolvedMesh3d]
Returns current visible custom meshes in stable managed-identity order. Missing or disabled View3d resources produce an empty slice.
Sourcepub fn screen_draws(&self) -> &[ScreenDraw]
pub fn screen_draws(&self) -> &[ScreenDraw]
Returns the exact screen composition after the world scene.
Contiguous primitive runs, images, and optional text share layer, depth, and stable source order. Exact same-source ties put rectangles first, then lines, circles, paths, images, and text. Empty screen content produces no items. This plan does not replace desktop aggregate budget checks.
Sourcepub fn screen_primitive_run_records(
&self,
run: usize,
) -> Option<impl Iterator<Item = ResolvedScreenPrimitive> + '_>
pub fn screen_primitive_run_records( &self, run: usize, ) -> Option<impl Iterator<Item = ResolvedScreenPrimitive> + '_>
Inspects one ScreenDraw::Primitives or ScreenDraw::Rectangles run.
Returns no iterator for an absent run; records borrow this snapshot and
retain exactly the order submitted to Engine, without allocation.
Sourcepub fn screen_rectangle_run_records(
&self,
run: usize,
) -> Option<&[ResolvedScreenRectangle]>
pub fn screen_rectangle_run_records( &self, run: usize, ) -> Option<&[ResolvedScreenRectangle]>
Returns just the rectangle records for one run in screen_draws.
A vector-only run returns an empty slice; an absent run returns None.
Auto Trait Implementations§
impl Freeze for ExtractedFrame
impl RefUnwindSafe for ExtractedFrame
impl Send for ExtractedFrame
impl Sync for ExtractedFrame
impl Unpin for ExtractedFrame
impl UnsafeUnpin for ExtractedFrame
impl UnwindSafe for ExtractedFrame
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
impl<T> ConditionalSend for Twhere
T: Send,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can
then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be
further downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.