Struct Decoder 

pub struct Decoder { /* private fields */ }

JPEG decoder.

Implementations

impl Decoder

pub fn new() -> Self

Creates a new decoder with default settings.

pub fn from_config(config: DecoderConfig) -> Self

Creates a decoder from configuration.

pub fn output_format(self, format: PixelFormat) -> Self

Sets the output pixel format.

pub fn fancy_upsampling(self, enable: bool) -> Self

Enables fancy upsampling.

pub fn block_smoothing(self, enable: bool) -> Self

Enables block smoothing.

pub fn apply_icc(self, enable: bool) -> Self

Enables ICC profile application.

When enabled, embedded ICC profiles will be applied to convert the image to sRGB. This is required for correct display of XYB-encoded images.

Note: Requires cms-lcms2 or cms-moxcms feature to be enabled. Without a CMS feature, this setting has no effect.

pub fn max_pixels(self, pixels: u64) -> Self

Sets the maximum number of pixels allowed (for DoS protection).

Default is 100 megapixels. Set to 0 for unlimited.

pub fn max_memory(self, bytes: usize) -> Self

Sets the maximum memory allowed for allocations during decoding.

Default is 512 MB. Set to usize::MAX for unlimited. This prevents memory exhaustion attacks from malicious images.

pub fn read_info(&self, data: &[u8]) -> Result<JpegInfo>

Reads JPEG info without decoding.

pub fn decode(&self, data: &[u8]) -> Result<DecodedImage>

Decodes a JPEG image.

pub fn decode_f32(&self, data: &[u8]) -> Result<DecodedImageF32>

Decodes a JPEG image to 32-bit floating point pixels.

This preserves the full 12-bit internal precision of jpegli’s decoder without quantization to 8-bit. Values are normalized to range 0.0-1.0.

Example

use jpegli::decode::Decoder;

let decoder = Decoder::new();
let image = decoder.decode_f32(&jpeg_data)?;
// image.data contains f32 values in range 0.0-1.0

Note: ICC profile application is not supported for f32 output. If you need ICC profile transformation, decode to u8 first.

Trait Implementations

impl Default for Decoder

fn default() -> Self

Returns the “default value” for a type.