Enum RendererError

pub enum RendererError {
    RequestAdapterFailed,
    RequestDeviceFailed(String),
    SurfaceCapabilitiesUnavailable(&'static str),
    SurfaceConfigFailed,
    SurfaceRecreationRequired(&'static str),
    SurfaceConfigureExhausted,
    CaptureUnsupportedFormat(TextureFormat),
    CaptureMapFailed(String),
    FrameTextureUnavailable,
    RenderTargetUnavailable(&'static str),
    SurfaceAcquireFailed(String),
    SurfaceAcquireTimeout,
    SurfaceAcquireLost,
    SurfaceAcquireOutdated,
    SurfaceAcquireOutOfMemory,
    SurfaceNotReady(String),
}

Failure during adapter/device setup, surface configuration, or capture readback.

Examples

use ailloli_ui_render_wgpu::RendererError;
let error = RendererError::SurfaceAcquireTimeout;
assert!(error.to_string().contains("Timeout"));

Variants

RequestAdapterFailed

No adapter matching the requested backend and surface was available.

RequestDeviceFailed(String)

Device creation failed; the string contains wgpu’s diagnostic.

SurfaceCapabilitiesUnavailable(&'static str)

The surface returned no usable capabilities for the named property.

SurfaceConfigFailed

A surface configuration could not be constructed.

SurfaceRecreationRequired(&'static str)

The current renderer pipelines cannot be reused with the surface’s new preferred format. The presentation adapter must rebuild the renderer.

SurfaceConfigureExhausted

No compatible adapter succeeded at Surface::configure (wgpu 0.20 may panic instead of returning an error).

CaptureUnsupportedFormat(TextureFormat)

Capture was requested from a format not handled by the RGBA readback path.

CaptureMapFailed(String)

Mapping the GPU capture buffer failed.

FrameTextureUnavailable

A render target exposed only a view where a backing texture was required.

RenderTargetUnavailable(&'static str)

The requested renderer mode has no compatible render target.

SurfaceAcquireFailed(String)

Frame acquisition failed with an untyped host diagnostic.

SurfaceAcquireTimeout

Surface acquisition timed out; hosts may skip and retry a later frame.

SurfaceAcquireLost

The surface was lost and should be recreated or reconfigured.

SurfaceAcquireOutdated

The surface is outdated and should be reconfigured before retrying.

SurfaceAcquireOutOfMemory

The GPU cannot allocate the frame; callers should terminate rendering.

SurfaceNotReady(String)

The surface exists but is not ready, commonly because one axis is zero.

Implementations

impl RendererError

pub fn from_surface_error(error: SurfaceError) -> Self

Converts wgpu’s typed acquisition failure without string parsing.

Examples

use ailloli_ui_render_wgpu::RendererError;
let error = RendererError::from_surface_error(wgpu::SurfaceError::Lost);
assert!(matches!(error, RendererError::SurfaceAcquireLost));

Trait Implementations

impl Debug for RendererError

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

Formats the value using the given formatter.

impl Display for RendererError

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

Formats the value using the given formatter.

impl Error for RendererError

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.