Struct JxlConfig 

pub struct JxlConfig {
    pub quality: Option<f32>,
    pub effort: JxlEffort,
    pub progressive: bool,
    pub photon_noise_iso: Option<u32>,
    pub extra_channels: u8,
    pub modular: bool,
    pub color_space: JxlColorSpace,
    pub bit_depth: u8,
}

JPEG-XL still image encoding configuration.

Supports both lossless and lossy encoding with advanced options like progressive decoding, effort level, and photon noise ISO simulation.

Fields

quality: Option<f32>

Quality level for lossy encoding (1.0 = visually lossless, 100.0 = worst).

Set to None for lossless mode.

effort: JxlEffort

Encoding effort (1 = fastest, 10 = best compression).

progressive: bool

Enable progressive decoding (DC first, then AC passes).

photon_noise_iso: Option<u32>

Photon noise ISO equivalent for denoising during encode.

Setting this enables noise modelling: the encoder treats pixel noise at the specified ISO level as irrelevant, yielding smaller files for high-ISO photographs.

extra_channels: u8

Number of extra channels (e.g. alpha, depth).

modular: bool

Enable modular mode (better for lossless, graphics, low-complexity images).

color_space: JxlColorSpace

Color space: “rgb”, “xyb” (perceptual, default for lossy), “gray”.

bit_depth: u8

Bit depth per channel (8, 10, 12, 16, 32).

Implementations

impl JxlConfig

pub fn new() -> Self

Creates a new JPEG-XL configuration with balanced defaults (lossy, quality 75).

pub fn lossless() -> Self

Lossless encoding preset.

Uses modular mode with RGB color space for mathematically lossless compression. Best for graphics, screenshots, and archival.

pub fn web() -> Self

Web delivery preset.

Lossy with progressive decoding for fast web rendering. Quality 80 gives excellent visual quality at small file sizes.

pub fn photography() -> Self

Photography preset.

Visually lossless encoding with photon noise modelling at ISO 400. Ideal for camera RAW conversions and photo archives.

pub fn with_quality(self, quality: f32) -> Self

Sets the quality level (1.0 = visually lossless, 100.0 = worst).

pub fn with_effort(self, effort: JxlEffort) -> Self

Sets the encoding effort.

pub fn with_progressive(self, progressive: bool) -> Self

Enables or disables progressive decoding.

pub fn with_photon_noise(self, iso: u32) -> Self

Sets the photon noise ISO for noise modelling.

pub fn with_bit_depth(self, depth: u8) -> Self

Sets the bit depth per channel.

pub fn with_modular(self, modular: bool) -> Self

Enables modular mode (better for lossless/graphics).

pub fn is_lossless(&self) -> bool

Returns true if this is a lossless configuration.

pub fn build(self) -> CodecConfig

Builds a CodecConfig from this JPEG-XL configuration.

Trait Implementations

impl Clone for JxlConfig

fn clone(&self) -> JxlConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JxlConfig

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

Formats the value using the given formatter.

impl Default for JxlConfig

fn default() -> Self

Returns the “default value” for a type.