Skip to main content

ExtractedFrame

Struct ExtractedFrame 

Source
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

Source

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.

Source

pub const fn world_generation(&self) -> WorldGeneration

Returns the World generation from which this snapshot was extracted.

Source

pub const fn background(&self) -> Color

Returns the normalized clear color for the composed frame.

Source

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.

Source

pub fn resolved_circles(&self) -> &[ResolvedCircle]

Returns value-comparable circles in their relative mixed-scene order.

Source

pub fn resolved_rectangles(&self) -> &[ResolvedRectangle]

Returns value-comparable rectangles in their relative mixed-scene order.

Source

pub fn resolved_lines(&self) -> &[ResolvedLine]

Returns nonzero lines in their relative mixed-scene order.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

pub fn resolved_cuboids(&self) -> &[ResolvedCuboid3d]

Returns current visible cuboids in stable managed-identity order.

Missing or disabled View3d resources produce an empty slice.

Source

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.

Source

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.

Source

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.

Source

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§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> ConditionalSend for T
where T: Send,

Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert 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>

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

Convert &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)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync> ⓘ

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<S> FromSample<S> for S

Source§

fn from_sample_(s: S) -> S

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoResult<T> for T

Source§

fn into_result(self) -> Result<T, RunSystemError>

Converts this type into the system output type.
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

Source§

fn to_sample_(self) -> U

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WasmNotSend for T
where T: Send,

Source§

impl<T> WasmNotSendSync for T

Source§

impl<T> WasmNotSync for T
where T: Sync,

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more