Enum SurfaceContextReuseFailure

#[non_exhaustive]
pub enum SurfaceContextReuseFailure {
    AdapterUnsupported,
    CapabilitiesDeferred(SurfaceConfigDeferredReason),
    FormatUnsupported,
    ConfigureFailed,
}

Why a newly-created surface could not reuse the current GPU context.

These conditions are not fatal by themselves: reattachment falls back to selecting another adapter and rebuilding device-bound renderer resources.

Examples

use ailloli_ui_render_wgpu::pipeline_cache::{
    SurfaceConfigDeferredReason, SurfaceContextReuseFailure,
};

let failure = SurfaceContextReuseFailure::CapabilitiesDeferred(
    SurfaceConfigDeferredReason::NoFormats,
);
assert!(matches!(failure, SurfaceContextReuseFailure::CapabilitiesDeferred(_)));

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.

AdapterUnsupported

The retained adapter cannot present to the new surface.

CapabilitiesDeferred(SurfaceConfigDeferredReason)

The new surface does not yet advertise usable capabilities.

FormatUnsupported

The surface cannot use the format baked into the retained pipelines.

ConfigureFailed

wgpu rejected or panicked while configuring the surface.

Trait Implementations

impl Clone for SurfaceContextReuseFailure

fn clone(&self) -> SurfaceContextReuseFailure

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SurfaceContextReuseFailure

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

Formats the value using the given formatter.

impl PartialEq for SurfaceContextReuseFailure

fn eq(&self, other: &SurfaceContextReuseFailure) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SurfaceContextReuseFailure

impl Eq for SurfaceContextReuseFailure

impl StructuralPartialEq for SurfaceContextReuseFailure