Enum ReadbackFailure 

#[non_exhaustive]
pub enum ReadbackFailure {
    UnsupportedTarget,
    Layout,
    DuplicateMapRequest,
    MapFailed,
    CallbackDropped,
    NotMapped,
    DestinationTooSmall,
    SubmissionMismatch,
}

Where a texture readback failed.

A failed buffer mapping carries no cause in wgpu 30 (BufferAsyncError is a unit), so Self::MapFailed says only that the mapping was refused. Whether the device was lost or out of memory at the time is for the device’s diagnostics (alpha2_gpu::GpuDiagnosticLog) to show; none of these is itself evidence of memory exhaustion.

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.

UnsupportedTarget

The rendered texture’s format or size is not one the readback packs.

Layout

A row, plane, or buffer size overflowed or could not be represented.

DuplicateMapRequest

Mapping was requested twice for one readback.

MapFailed

The GPU refused to map the staging buffer.

CallbackDropped

The mapping callback was dropped without reporting.

NotMapped

The staging buffer was read before its mapping succeeded.

DestinationTooSmall

A caller-supplied plane destination is too small for the frame.

SubmissionMismatch

The device was polled for a submission it did not recognise.

Implementations

impl ReadbackFailure

pub const fn as_str(self) -> &'static str

Stable lowercase name for logs and protocols.

Trait Implementations

impl Clone for ReadbackFailure

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReadbackFailure

impl Debug for ReadbackFailure

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

Formats the value using the given formatter.

impl Display for ReadbackFailure

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

Formats the value using the given formatter.

impl Eq for ReadbackFailure

impl PartialEq for ReadbackFailure

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReadbackFailure