Enum GpuError 

#[non_exhaustive]
pub enum GpuError {
    NoKernels,
    LibraryLoad(String),
    MissingKernel(String),
    Pipeline {
        name: String,
        message: String,
    },
    InvalidArgument(String),
    BufferInUse,
    OutOfMemory(usize),
    CommandBuffer(String),
    Io(String),
    ReadOnly,
}

Why a GPU operation failed.

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.

NoKernels

This build embeds no kernel library. Builds for macOS (15 or later, nuvec’s floor) always embed one, precompiled or as runtime sources, so they never report this.

LibraryLoad(String)

The kernel library could not be loaded or compiled.

MissingKernel(String)

No kernel with this name exists in the library.

Pipeline

A compute pipeline could not be created.

Fields

name: String

The kernel name.

message: String

Metal’s description.

InvalidArgument(String)

A dispatch argument is invalid (offset out of range, too many arguments, …).

BufferInUse

The buffer is used by submitted GPU work that has not been waited on.

OutOfMemory(usize)

Metal could not allocate a buffer or command object of this many bytes.

CommandBuffer(String)

The command buffer failed on the GPU.

Io(String)

A file could not be opened or mapped.

ReadOnly

The buffer is a read-only mapped file.

Trait Implementations

impl Clone for GpuError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GpuError

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

Formats the value using the given formatter.

impl Display for GpuError

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

Formats the value using the given formatter.

impl Eq for GpuError

impl Error for GpuError

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 PartialEq for GpuError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GpuError