Struct ImageDecoder 

pub struct ImageDecoder { /* private fields */ }

Reusable image decoder with internal scratch buffers.

Create one ImageDecoder at program initialisation and pass it to ImageLoad::load_image in the hot loop. The scratch buffers grow to the high-water mark and are reused across calls — no per-frame allocations after the first few frames.

Example

use edgefirst_codec::{ImageDecoder, ImageLoad, DecodeOptions};
use edgefirst_tensor::{Tensor, TensorTrait, TensorMemory, PixelFormat};

let mut decoder = ImageDecoder::new();
let mut tensor = Tensor::<u8>::image(1920, 1080, PixelFormat::Rgb, Some(TensorMemory::Mem))
    .expect("alloc");

for _ in 0..100 {
    let frame = std::fs::read("frame.jpg").unwrap();
    let _info = tensor.load_image(&mut decoder, &frame, &DecodeOptions::default());
}

Implementations

impl ImageDecoder

pub fn new() -> Self

Create a new decoder with empty scratch buffers.

pub fn decode_into<T: ImagePixel>( &mut self, data: &[u8], dst: &mut Tensor<T>, opts: &DecodeOptions, ) -> Result<ImageInfo>

Decode image data into a typed tensor.

Detects the image format (JPEG or PNG) from magic bytes and decodes into dst. The tensor must have sufficient capacity for the decoded image dimensions.

Errors

• CodecError::InsufficientCapacity if image dimensions exceed tensor
• CodecError::UnsupportedDtype if T is not a supported pixel type
• CodecError::InvalidData if the data is not a valid JPEG or PNG

pub fn decode_into_dyn( &mut self, data: &[u8], dst: &mut TensorDyn, opts: &DecodeOptions, ) -> Result<ImageInfo>

Decode image data into a type-erased tensor.

Dispatches to the appropriate typed decode path based on the tensor’s DType.

pub fn decode_from_reader<T: ImagePixel, R: Read>( &mut self, reader: R, dst: &mut Tensor<T>, opts: &DecodeOptions, ) -> Result<ImageInfo>

Read all bytes from a Read source into the internal input buffer, then decode. The input buffer is reused across calls — no per-call heap copy of the encoded bytes.

pub fn decode_from_reader_dyn<R: Read>( &mut self, reader: R, dst: &mut TensorDyn, opts: &DecodeOptions, ) -> Result<ImageInfo>

Read all bytes from a Read source into the internal input buffer, then decode into a type-erased tensor.

Trait Implementations

impl Default for ImageDecoder

fn default() -> Self

Returns the “default value” for a type.