Enum SurfaceError 

#[non_exhaustive]
pub enum SurfaceError {
    Init(String),
    Frame(String),
    DeviceLost(String),
}

A failure creating or driving the wgpu device and surface.

The variants split along the one distinction the event loop acts on: whether retrying is worth anything. RecoverableError reads that split, and retroglyph_window::winit::run uses it to decide between logging-and-continuing and exiting.

Variants (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.

Init(String)

No adapter, device, or surface could be created for this window.

Treated as fatal: without a device there is nothing to draw with, and retrying the same request against the same hardware will fail the same way. Usually means the requested backends are all unavailable (no Vulkan/Metal/D3D12 driver), which WGPU_BACKEND can sometimes work around.

Frame(String)

Acquiring the next frame from the swap chain failed for a reason reconfiguring can’t fix.

Treated as recoverable so the event loop’s consecutive-failure heuristic can retry: a timed-out or occluded frame usually resolves on its own, and the crate reconfigures the surface itself for the outdated/lost cases before ever returning this.

DeviceLost(String)

The device was lost (a GPU reset, a driver update, or an eviction) and every resource created from it is now invalid.

Treated as recoverable, because the recovery that helps is the one the event loop performs: after enough consecutive present failures it calls Presenter::init_surface again, which rebuilds the adapter, device, surface, and every GPU resource from scratch. Reporting this as unrecoverable would skip that path, leaving the loop logging the same failure every frame with nothing rebuilding.

Trait Implementations

impl Debug for SurfaceError

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

Formats the value using the given formatter.

impl Display for SurfaceError

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

Formats the value using the given formatter.

impl Error for SurfaceError

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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.

impl RecoverableError for SurfaceError

fn is_recoverable(&self) -> bool

Whether this error represents a transient failure worth retrying, as opposed to a fatal one.