Enum WgpuBackendError 

pub enum WgpuBackendError {
    NoAdapter,
    CreateSurface(String),
    Init(String),
    RequestDevice(String),
    Surface(SurfaceError),
}

Errors that can occur while initializing or presenting through wgpu.

Examples

use cotis_wgpu::WgpuBackendError;

assert_eq!(
    WgpuBackendError::NoAdapter.to_string(),
    "no compatible wgpu adapter found"
);
assert_eq!(
    WgpuBackendError::Init("window closed".into()).to_string(),
    "failed to initialize renderer: window closed"
);

Variants

NoAdapter

No compatible GPU adapter was found during GPU device initialization.

Occurs when wgpu cannot enumerate a suitable adapter for the current platform.

CreateSurface(String)

Failed to create the window surface from the winit window handle.

Returned by crate::surface::SurfaceState::new when create_surface_unsafe fails.

Init(String)

Failed to initialize the winit event loop or create the window.

Also returned when the window is closed before bootstrap completes.

RequestDevice(String)

Failed to request a logical device and queue from the adapter.

Occurs when wgpu request_device fails during startup.

Surface(SurfaceError)

The swapchain surface reported an error while acquiring or presenting a frame.

crate::surface::SurfaceState::acquire_frame retries once on wgpu::SurfaceError::Lost or wgpu::SurfaceError::Outdated after reconfiguring.

Trait Implementations

impl Debug for WgpuBackendError

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

Formats the value using the given formatter.

impl Display for WgpuBackendError

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

Formats the value using the given formatter.

impl Error for WgpuBackendError

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<EventLoopError> for WgpuBackendError

fn from(value: EventLoopError) -> Self

Converts to this type from the input type.