Struct JpegBatchSession 

pub struct JpegBatchSession { /* private fields */ }

Reusable JPEG tile-batch runtime for WSI viewport loops.

The session keeps one decoder context and scratch pool per active worker during a batch and retains worker slots across calls. Before planning the next batch it may preserve one bounded decoder context, while evicting stale scratch and other contexts so the planning decoder retains the full codec memory allowance. Callers continue to own compressed inputs and decoded output buffers.

Implementations

impl JpegBatchSession

pub fn new(options: TileBatchOptions) -> Self

Create a session using the given CPU batch worker options.

pub fn options(&self) -> TileBatchOptions

Return current worker options.

pub fn set_options(&mut self, options: TileBatchOptions)

Replace worker options for future decode calls.

pub fn reset(&mut self)

Clear worker-local decode contexts and scratch pools while retaining slots.

pub fn decode_tiles_into( &mut self, jobs: &mut [TileDecodeJob<'_, '_>], fmt: PixelFormat, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode full JPEG tiles into caller-owned output buffers.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

pub fn decode_tiles_into_with_options( &mut self, jobs: &mut [TileDecodeJob<'_, '_>], fmt: PixelFormat, decode_options: DecodeOptions, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode full JPEG tiles with explicit JPEG decode options.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

pub fn decode_prepared_jpeg_tiles_rgb8( &mut self, jobs: &mut [PreparedJpegTileJob<'_, '_>], ) -> Result<Vec<Result<DecodedTile, JpegError>>, BatchInfrastructureError>

Decode prepared TIFF/WSI JPEG tiles into caller-owned RGB8 buffers.

Results preserve the caller’s input order and retain each tile’s error independently instead of collapsing the batch to the first failure.

Errors

Returns a typed batch infrastructure error for planning, allocation, scheduling, or ordered-collection failures.

pub fn decode_tiles_scaled_into( &mut self, jobs: &mut [TileScaledDecodeJob<'_, '_>], fmt: PixelFormat, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode scaled JPEG tiles into caller-owned output buffers.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

pub fn decode_tiles_scaled_into_with_options( &mut self, jobs: &mut [TileScaledDecodeJob<'_, '_>], fmt: PixelFormat, decode_options: DecodeOptions, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode scaled JPEG tiles with explicit JPEG decode options.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

pub fn decode_tiles_region_scaled_into( &mut self, jobs: &mut [TileRegionScaledDecodeJob<'_, '_>], fmt: PixelFormat, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode scaled JPEG tile regions into caller-owned output buffers.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

pub fn decode_tiles_region_scaled_into_with_options( &mut self, jobs: &mut [TileRegionScaledDecodeJob<'_, '_>], fmt: PixelFormat, decode_options: DecodeOptions, ) -> Result<Vec<DecodeOutcome>, TileBatchError>

Decode scaled JPEG tile regions with explicit JPEG decode options.

Errors

Returns TileBatchError with the first codec failure in input order, or a typed infrastructure failure when no tile index applies.

Trait Implementations

impl Debug for JpegBatchSession

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

Formats the value using the given formatter.

impl Default for JpegBatchSession

fn default() -> Self

Returns the “default value” for a type.