Enum RenderError 

pub enum RenderError {
    NotInitialized,
    InitializationFailed(String),
    SurfaceAcquisitionFailed(String),
    RenderingFailed(String),
    ResourceError(ResourceError),
    DeviceLost,
    DeviceOutOfMemory(String),
    Internal(String),
}

A high-level error that can occur within the main rendering system or graphics device.

Variants

NotInitialized

An operation was attempted before the rendering system was initialized.

InitializationFailed(String)

A failure occurred during the initialization of the graphics backend.

SurfaceAcquisitionFailed(String)

Failed to acquire the next frame from the swapchain/surface for rendering.

RenderingFailed(String)

A critical, unrecoverable rendering operation failed.

ResourceError(ResourceError)

An error occurred while managing a GPU resource.

DeviceLost

The graphics device was lost (e.g., GPU driver crashed or was updated). This is a catastrophic error that typically requires reinitialization.

DeviceOutOfMemory(String)

The graphics device or surface ran out of memory.

This is fatal but non-panicking: the frame loop surfaces it so the host can decide to shut down cleanly rather than crashing mid-frame.

Internal(String)

An unexpected or internal error occurred.

Implementations

impl RenderError

pub fn is_fatal(&self) -> bool

Whether this error is fatal — i.e. the render system cannot make progress on subsequent frames and the host should tear down or reinitialize rather than retry.

Transient acquisition failures (surface lost/outdated/timeout, occluded or zero-size windows) are not fatal: the loop skips the frame and retries. Device loss and out-of-memory are fatal.

Trait Implementations

impl Debug for RenderError

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

Formats the value using the given formatter.

impl Display for RenderError

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

Formats the value using the given formatter.

impl Error for RenderError

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 From<ResourceError> for RenderError

fn from(err: ResourceError) -> Self

Converts to this type from the input type.