Skip to main content

ExtractionError

Enum ExtractionError 

Source
#[non_exhaustive]
pub enum ExtractionError {
Show 28 variants ScreenPrimitiveLimitExceeded { entity: LogicEntity, limit: usize, }, ScreenPolylinePointsLimitExceeded { entity: LogicEntity, limit: usize, requested: usize, }, MissingStagedFrame, ThreeD(ThreeDExtractionError), MissingActiveCamera, MultipleActiveCameras, InvalidInterpolationAlpha { alpha: f32, }, ForeignEntity { entity: LogicEntity, expected: WorldGeneration, }, InvalidVisual { entity: LogicEntity, error: VisualValueError, }, InvalidInterpolatedTranslation { entity: LogicEntity, }, InvalidResolvedRectangle { entity: LogicEntity, }, InvalidResolvedLine { entity: LogicEntity, }, CircleLimitExceeded { limit: usize, }, RectangleLimitExceeded { limit: usize, }, LineLimitExceeded { limit: usize, }, ScreenRectangleLimitExceeded { limit: usize, }, ScreenImageLimitExceeded { limit: usize, }, ScreenTextLimitExceeded { limit: usize, }, ScreenTextBytesLimitExceeded { limit: usize, requested: usize, }, ScreenTextGlyphLimitExceeded { limit: usize, requested: usize, }, UnregisteredTextFont { entity: LogicEntity, font: TextFont, }, InvalidScreenText { entity: LogicEntity, error: TextError, }, UnregisteredImageAsset { entity: LogicEntity, image: ImageAssetId, }, InvalidScreenImage { entity: LogicEntity, error: ImageVisualError, }, InvalidScreenVisual { entity: LogicEntity, error: ScreenVisualError, }, AllocationFailed { requested_bytes: usize, }, Scene(SceneError), ScreenScene(SceneError),
}
Expand description

Structured reason why a new CPU visual snapshot was not published.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

ScreenPrimitiveLimitExceeded

A screen line/circle/path source count exceeded its explicit per-kind limit.

Fields

§entity: LogicEntity

First source that exceeded the limit.

§limit: usize

Configured maximum for this primitive kind.

§

ScreenPolylinePointsLimitExceeded

Enabled path points exceeded their aggregate CPU limit, including hidden clips.

Fields

§entity: LogicEntity

Path that would exceed the limit.

§limit: usize

Configured aggregate path-point limit.

§requested: usize

Requested total, or usize::MAX on arithmetic overflow.

§

MissingStagedFrame

A private staged snapshot was unavailable for completing 3D extraction.

§

ThreeD(ThreeDExtractionError)

Independent bounded 3D snapshot preparation failed.

§

MissingActiveCamera

The active World did not contain a camera marked for extraction.

§

MultipleActiveCameras

The active World contained more than one marked camera.

§

InvalidInterpolationAlpha

Interpolation alpha was non-finite or outside the inclusive 0.0..=1.0 range.

Fields

§alpha: f32

Rejected accumulator fraction.

§

ForeignEntity

A visual entity did not belong to the generation being extracted.

Fields

§entity: LogicEntity

Entity that carried stale or foreign provenance.

§expected: WorldGeneration

Generation accepted by this extraction.

§

InvalidVisual

A component contained a value outside its public visual contract.

Fields

§entity: LogicEntity

Entity whose visual data was rejected.

§error: VisualValueError

Exact invalid value category.

§

InvalidInterpolatedTranslation

Interpolation of two finite translations did not produce a finite result.

Fields

§entity: LogicEntity

Entity whose interpolation failed.

§

InvalidResolvedRectangle

A finite center and size produced collapsed or non-finite f32 bounds.

Fields

§entity: LogicEntity

Entity whose derived bounds were not representable.

§

InvalidResolvedLine

An interpolated anchor and finite vector did not form a representable segment.

Fields

§entity: LogicEntity

Entity whose resolved segment was rejected.

§

CircleLimitExceeded

The configured extracted-circle count was exceeded.

Fields

§limit: usize

Configured maximum resolved circle count.

§

RectangleLimitExceeded

The configured extracted-rectangle count was exceeded.

Fields

§limit: usize

Configured maximum resolved rectangle count.

§

LineLimitExceeded

The configured enabled line-source count was exceeded.

Fields

§limit: usize

Configured maximum line-source count.

§

ScreenRectangleLimitExceeded

The configured enabled screen-rectangle count was exceeded.

Fields

§limit: usize

Maximum number of screen rectangles accepted in one extraction.

§

ScreenImageLimitExceeded

The opted-in enabled screen-image source count was exceeded.

Fields

§limit: usize

Configured image source limit (zero by default).

§

ScreenTextLimitExceeded

The opted-in enabled screen-text source count was exceeded.

Fields

§limit: usize

Configured label count limit, zero by default.

§

ScreenTextBytesLimitExceeded

Aggregate enabled label strings exceed the UTF-8 byte allowance.

Fields

§limit: usize

Configured inclusive UTF-8 byte limit.

§requested: usize

Requested aggregate bytes; usize::MAX also represents overflow.

§

ScreenTextGlyphLimitExceeded

Aggregate enabled labels exceed the shaped-glyph allowance.

Fields

§limit: usize

Configured inclusive shaped-glyph count limit.

§requested: usize

Requested aggregate glyphs; usize::MAX also represents overflow.

§

UnregisteredTextFont

A label uses a font not registered by this Application.

Fields

§entity: LogicEntity

Managed source of the foreign or unavailable font.

§font: TextFont

Shared immutable font whose Application provenance was rejected.

§

InvalidScreenText

A label violated its prepared-text, position, or tint contract.

Fields

§entity: LogicEntity

Managed source whose text visual was rejected.

§error: TextError

Exact component validation failure.

§

UnregisteredImageAsset

An image handle was not registered by this Application.

Fields

§entity: LogicEntity

Managed source of the invalid reference.

§image: ImageAssetId

Rejected immutable image handle.

§

InvalidScreenImage

An image component violated its geometry, tint, or source-region contract.

Fields

§entity: LogicEntity

Managed source whose visual was rejected.

§error: ImageVisualError

Exact component validation failure.

§

InvalidScreenVisual

A screen visual violated its validated logical-pixel contract.

Fields

§entity: LogicEntity

Managed entity whose screen visual was rejected.

§error: ScreenVisualError

Exact invalid value category.

§

AllocationFailed

CPU storage for a bounded fixed-size resolved record could not be reserved.

Fields

§requested_bytes: usize

Minimum bytes requested for the next fixed-size record.

§

Scene(SceneError)

Sim;Engine rejected bounded scene construction.

§

ScreenScene(SceneError)

Sim;Engine rejected bounded screen-scene construction.

Trait Implementations§

Source§

impl Debug for ExtractionError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for ExtractionError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for ExtractionError

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type-based access to context intended for error reports. Read more

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> ToSmolStr for T
where T: Display + ?Sized,

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
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