Struct CudaLosslessEncoder 

pub struct CudaLosslessEncoder { /* private fields */ }

Reusable CUDA-aware lossless JPEG 2000 encoder.

Self::encode honors each job’s EncodeBackendPreference:

• CpuOnly does not initialize or submit CUDA work.
• Auto may use CUDA stages and returns a CPU result when CUDA is unavailable or the device route does not cover every required stage.
• RequireDevice returns an error unless CUDA satisfies every required stage.

Auto does not retry on the CPU after a CUDA execution error. Such errors can indicate uncertain device state and are returned to the caller. The encoder discards its cached accelerator state after any error, so a later job can safely retry initialization or select CpuOnly.

The encoder is Send but intentionally not Sync; encoding requires exclusive &mut self access. Move one encoder to each worker, or put it behind a mutex when jobs must share it.

fn require_sync<T: Sync>() {}
require_sync::<j2k_cuda::CudaLosslessEncoder>();

Implementations

impl CudaLosslessEncoder

pub fn new() -> Self

Create a reusable encoder with lazily initialized CUDA state.

pub fn encode( &mut self, samples: J2kLosslessSamples<'_>, options: &J2kLosslessEncodeOptions, ) -> Result<CudaLosslessEncodeResult, Error>

Encode one job according to its backend preference.

Device unavailability and incomplete device-stage coverage are recoverable only for Auto. Input, allocation, validation, and CUDA execution errors are returned without a second CPU encode attempt.

pub fn encode_strict_cuda( &mut self, samples: J2kLosslessSamples<'_>, options: &J2kLosslessEncodeOptions, ) -> Result<CudaLosslessEncodeResult, Error>

Encode one job with a strict CUDA contract.

This method ignores the job’s stored backend preference and behaves as EncodeBackendPreference::RequireDevice. It exists alongside Self::encode so CUDA-specific callers can opt into fail-closed routing without changing reusable per-job option templates.

Trait Implementations

impl Debug for CudaLosslessEncoder

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

Formats the value using the given formatter.

impl Default for CudaLosslessEncoder

fn default() -> Self

Returns the “default value” for a type.