Struct JpegOutputBuffer 

pub struct JpegOutputBuffer { /* private fields */ }

Caller-owned reusable host pixel buffer.

The buffer uses a tight stride by default and can be resized across viewport reads. Resizing to a same-or-smaller byte requirement keeps existing vector capacity, so callers can reuse allocations while still passing ordinary &mut [u8] slices into decode APIs.

Implementations

impl JpegOutputBuffer

pub fn new( dimensions: (u32, u32), fmt: PixelFormat, ) -> Result<Self, BufferError>

Create a tightly packed output buffer for dimensions and fmt.

Uses the shared default host allocation cap.

Errors

Returns BufferError if the requested shape overflows byte counts, exceeds the default host allocation cap, or cannot be reserved.

pub fn with_stride( dimensions: (u32, u32), stride: usize, fmt: PixelFormat, ) -> Result<Self, BufferError>

Create an output buffer with an explicit row stride.

Uses the shared default host allocation cap.

Errors

Returns BufferError if the stride is too small, sizes overflow, the allocation exceeds the default host allocation cap, or reservation fails.

pub fn resize( &mut self, dimensions: (u32, u32), fmt: PixelFormat, ) -> Result<(), BufferError>

Resize to a tightly packed output shape.

Uses the shared default host allocation cap.

Existing decoded bytes may be discarded when the allocation must grow or stale capacity exceeds the active cap.

Errors

Returns BufferError if the requested shape overflows byte counts, exceeds the default host allocation cap, or cannot be reserved.

pub fn resize_with_stride( &mut self, dimensions: (u32, u32), stride: usize, fmt: PixelFormat, ) -> Result<(), BufferError>

Resize with an explicit row stride.

Uses the shared default host allocation cap. Existing decoded bytes may be discarded when storage must be replaced.

Errors

Returns BufferError if the stride is too small, sizes overflow, the allocation exceeds the default host allocation cap, or reservation fails.

pub fn as_slice(&self) -> &[u8]

Borrow the decoded pixel bytes.

pub fn as_mut_slice(&mut self) -> &mut [u8]

Mutably borrow the decoded pixel bytes.

pub fn dimensions(&self) -> (u32, u32)

Current dimensions in pixels.

pub fn stride(&self) -> usize

Current row stride in bytes.

pub fn pixel_format(&self) -> PixelFormat

Current pixel format.

pub fn len(&self) -> usize

Current logical byte length.

pub fn is_empty(&self) -> bool

Whether the logical byte length is zero.

pub fn capacity(&self) -> usize

Retained vector capacity in bytes.

Trait Implementations

impl Debug for JpegOutputBuffer

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

Formats the value using the given formatter.