Skip to main content

DesktopRunError

Enum DesktopRunError 

Source
pub enum DesktopRunError {
Show 19 variants Runner(RunnerBuildError), EventLoop(EventLoopError), Window(OsError), WindowMode(WindowModeFailure), RendererConfiguration(RendererConfigurationError), RendererConfigurationAfterFrame { error: RendererConfigurationError, logic_frame: Box<LogicFrameReport>, }, LogicalViewport(LogicalViewportError), Pointer(DesktopPointerError), RendererInitialization(RendererInitError), InputEventLimitExceeded { limit: usize, }, InputBufferAllocationFailed, BeginFrame(BeginFrameRejection), RuntimeInvariant, LogicFrame { report: Box<LogicFrameReport>, diagnostic_presentation: Box<Result<FrameReport, FrameComposerError>>, }, Presentation { error: FrameComposerError, logic_frame: Box<LogicFrameReport>, }, ImagePreparation { error: DesktopImageError, logic_frame: Box<LogicFrameReport>, }, TextPreparation { error: DesktopTextError, logic_frame: Box<LogicFrameReport>, }, ThreeDPreparation { error: DesktopThreeDError, logic_frame: Box<LogicFrameReport>, }, Recovery { error: RendererInitError, logic_frame: Box<LogicFrameReport>, },
}
Expand description

Fatal reason the one-window desktop loop stopped.

Variants§

§

Runner(RunnerBuildError)

The shared logical runner could not be built.

§

EventLoop(EventLoopError)

Winit could not create or drive its event loop.

§

Window(OsError)

Winit could not create the application window.

§

WindowMode(WindowModeFailure)

The initial fullscreen request could not be submitted; no fallback is hidden.

§

RendererConfiguration(RendererConfigurationError)

Sim;Engine rejected display or resize configuration.

§

RendererConfigurationAfterFrame

Surface reconfiguration failed after one logical frame had already completed successfully.

Fields

§error: RendererConfigurationError

Renderer resize or scale configuration failure.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome that preceded reconfiguration.

§

LogicalViewport(LogicalViewportError)

Sim;Engine could not derive a positive finite logical viewport.

§

Pointer(DesktopPointerError)

Delivered desktop pointer geometry could not form a valid logical sample.

§

RendererInitialization(RendererInitError)

Sim;Engine could not create its renderer.

§

InputEventLimitExceeded

The bounded desktop collector received too many mapped input events.

Fields

§limit: usize

Frozen maximum mapped input events between logical frames.

§

InputBufferAllocationFailed

The desktop collector could not reserve bounded input storage.

§

BeginFrame(BeginFrameRejection)

The shared core rejected BeginFrame atomically.

§

RuntimeInvariant

A private desktop/core ownership invariant was violated.

§

LogicFrame

A logical frame began but ended with a typed stage or extraction failure. The adapter attempted one clear-only diagnostic presentation without reusing the last World snapshot.

Fields

§report: Box<LogicFrameReport>

Complete logical report for the failed frame.

§diagnostic_presentation: Box<Result<FrameReport, FrameComposerError>>

Result of the separate diagnostic-only presentation attempt.

§

Presentation

Sim;Engine rejected frame composition or presentation after the logical frame had already completed.

Fields

§error: FrameComposerError

Renderer or frame-composer failure.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome that preceded the presentation failure.

§

ImagePreparation

Preparing an uncached screen image failed after the logical frame completed. Previously uploaded immutable assets can remain cached; the adapter does not present a partially composed frame.

Fields

§error: DesktopImageError

Source-attributed image or cache preparation failure.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome that preceded image preparation.

§

TextPreparation

Preparing managed text failed after CPU publication. Earlier cache updates may remain, but no partial surface frame is presented.

Fields

§error: DesktopTextError

Source-attributed font atlas, glyph run, or cache failure.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome preceding the failure.

§

ThreeDPreparation

Preparing or submitting the separate 3D depth prepass failed after the logical frame completed. Retained resources can remain warmed; no partial surface frame is presented and canonical state is not rolled back.

Fields

§error: DesktopThreeDError

Concrete bounded preparation or whole-scene renderer error.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome preceding the failed 3D preparation.

§

Recovery

The one permitted recovery attempt for a lost surface failed after the logical frame had already completed.

Fields

§error: RendererInitError

Renderer recovery failure.

§logic_frame: Box<LogicFrameReport>

Canonical logical outcome that preceded the recovery attempt.

Trait Implementations§

Source§

impl Debug for DesktopRunError

Source§

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

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

impl Display for DesktopRunError

Source§

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

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

impl Error for DesktopRunError

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