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: RendererConfigurationErrorRenderer 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.
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: FrameComposerErrorRenderer 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: DesktopImageErrorSource-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: DesktopTextErrorSource-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: DesktopThreeDErrorConcrete 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: RendererInitErrorRenderer recovery failure.
logic_frame: Box<LogicFrameReport>Canonical logical outcome that preceded the recovery attempt.
Trait Implementations§
Source§impl Debug for DesktopRunError
impl Debug for DesktopRunError
Source§impl Display for DesktopRunError
impl Display for DesktopRunError
Source§impl Error for DesktopRunError
impl Error for DesktopRunError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()
Auto Trait Implementations§
impl !RefUnwindSafe for DesktopRunError
impl !UnwindSafe for DesktopRunError
impl Freeze for DesktopRunError
impl Send for DesktopRunError
impl Sync for DesktopRunError
impl Unpin for DesktopRunError
impl UnsafeUnpin for DesktopRunError
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.