Enum Error 

#[non_exhaustive]
pub enum Error {
    Decode(J2kError),
    NativeDecode {
        context: &'static str,
        source: NativeBackendError,
    },
    Buffer(BufferError),
    HostAllocationFailed {
        bytes: usize,
        what: &'static str,
    },
    HostAllocationTooLarge {
        requested: usize,
        cap: usize,
        what: &'static str,
    },
    HtJobChunkPlan(HtGpuJobChunkPlanError),
    UnsupportedBackend {
        request: BackendRequest,
    },
    UnsupportedCudaRequest {
        reason: &'static str,
    },
    CudaUnavailable,
    CudaRuntime {
        source: CudaError,
    },
    CudaTier1JobFailed {
        source_index: usize,
        original_job_index: usize,
        source: CudaError,
    },
    CudaCleanupFailed {
        primary: Box<Error>,
        cleanup: Box<Error>,
    },
}

Error returned by the CUDA JPEG 2000 adapter.

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.

Decode(J2kError)

CPU JPEG 2000 decode failed.

NativeDecode

Native decoder failure produced while preparing CUDA-resident work.

Fields

context: &'static str

Stable adapter operation context.

source: NativeBackendError

Concrete native decoder failure.

Buffer(BufferError)

Caller-owned output buffers were invalid.

HostAllocationFailed

A host-side allocation needed by the adapter could not be reserved.

Fields

bytes: usize

Requested allocation size in bytes.

what: &'static str

Logical allocation purpose.

HostAllocationTooLarge

Allocator-reported host capacity exceeds the codec phase budget.

Fields

requested: usize

Aggregate allocator-reported byte capacity.

cap: usize

Maximum permitted simultaneously live host bytes.

what: &'static str

Logical phase or owner graph.

HtJobChunkPlan(HtGpuJobChunkPlanError)

Bounded HTJ2K GPU job planning rejected one source job.

UnsupportedBackend

Backend request is unsupported by this adapter.

Fields

request: BackendRequest

Requested backend.

UnsupportedCudaRequest

CUDA request is unsupported by the strict CUDA adapter contract.

Fields

reason: &'static str

Human-readable rejection reason.

CudaUnavailable

CUDA runtime or device is unavailable.

CudaRuntime

CUDA runtime returned an error.

Fields

source: CudaError

Typed runtime failure, including nested completion or resource-release errors.

CudaTier1JobFailed

A classic JPEG 2000 or HTJ2K tier-1 descriptor failed during GPU execution.

Fields

source_index: usize

Original caller input index that owns the failed job.

original_job_index: usize

Stable job index before pass-bucket ordering and chunk splitting.

source: CudaError

Indexed CUDA kernel failure.

CudaCleanupFailed

A CUDA operation failed and the required resource cleanup also failed.

Fields

primary: Box<Error>

Error returned by the original operation.

cleanup: Box<Error>

Error returned while synchronizing or releasing queued resources.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<BufferError> for Error

fn from(source: BufferError) -> Self

Converts to this type from the input type.

impl From<J2kError> for Error

fn from(source: J2kError) -> Self

Converts to this type from the input type.