Struct CpuBatchDecoder 

pub struct CpuBatchDecoder { /* private fields */ }

Persistent CPU facade for repeated owned/prepared batch decode.

Prepared metadata is borrowed across calls. Decoder settings and worker policy are retained by the session. Each worker owns a lifetime-free native workspace whose decoded-component, Tier-1, and IDWT allocations move through the borrowing context and return to the worker after every group, including across calls. Supported Gray/RGB/RGBA classic and HTJ2K inputs execute their retained per-tile offset plans directly. Metadata-only inputs retain the general decode fallback.

Implementations

impl CpuBatchDecoder

pub fn new(options: BatchDecodeOptions) -> Self

Create a persistent CPU batch decoder.

pub const fn options(&self) -> BatchDecodeOptions

Retained session options.

pub fn retained_worker_count(&self) -> usize

Number of reusable worker context/scratch owners retained by this session.

pub fn workspace_stats(&self) -> CpuBatchWorkspaceStats

Aggregate native workspace reuse counters for this session.

pub fn prepare( &self, inputs: Vec<EncodedImage>, ) -> Result<PreparedBatch, BatchInfrastructureError>

Inspect and group owned encoded inputs for repeated decode.

pub fn prepare_prepared_images( &self, images: Vec<PreparedImage>, ) -> Result<PreparedBatch, BatchInfrastructureError>

Regroup caller-supplied prepared images under this session’s output policy.

pub fn decode( &mut self, inputs: Vec<EncodedImage>, ) -> Result<CpuBatchDecodeResult, BatchInfrastructureError>

Prepare and decode one batch.

pub fn decode_prepared_images( &mut self, images: Vec<PreparedImage>, ) -> Result<CpuBatchDecodeResult, BatchInfrastructureError>

Regroup and decode caller-supplied prepared images without reparsing them.

pub fn decode_prepared( &mut self, prepared: &PreparedBatch, ) -> Result<CpuBatchDecodeResult, BatchInfrastructureError>

Decode a previously prepared batch without consuming it.

Trait Implementations

impl BatchDecoder for CpuBatchDecoder

type Output = CpuBatchDecodeResult

Backend-specific successful output.

type Error = BatchInfrastructureError

Backend-specific infrastructure or execution error.

fn options(&self) -> BatchDecodeOptions

Preparation and output policy retained by this persistent session.

fn prepare_batch( &self, inputs: Vec<EncodedImage>, ) -> Result<PreparedBatch, Self::Error>

Inspect and group owned inputs without consuming their encoded byte owners.

fn prepare_prepared_images( &self, images: Vec<PreparedImage>, ) -> Result<PreparedBatch, Self::Error>

Regroup caller-supplied prepared images without reparsing their encoded bytes.

fn decode_prepared( &mut self, prepared: &PreparedBatch, ) -> Result<Self::Output, Self::Error>

Decode a reusable prepared batch without consuming its encoded inputs or plans.

fn decode_batch( &mut self, inputs: Vec<EncodedImage>, ) -> Result<Self::Output, Self::Error>

Prepare and decode one owned batch through the common session boundary.

fn decode_prepared_images( &mut self, images: Vec<PreparedImage>, ) -> Result<Self::Output, Self::Error>

Regroup and decode caller-supplied prepared images without reparsing them.

impl Debug for CpuBatchDecoder

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

Formats the value using the given formatter.