Struct LibjxlEncodeConfig 

pub struct LibjxlEncodeConfig {

    pub common: CommonEncodeOptions,
    pub distance: f32,
    pub quality: Option<f32>,
    pub lossless: bool,
    pub effort: u8,
    pub brotli_effort: i8,
    pub decoding_speed: u8,
    pub progressive: bool,
    pub modular: LibjxlModular,
    pub color_transform: LibjxlColorTransform,
    pub epf: i8,
    pub gaborish: Option<bool>,
    pub noise: Option<bool>,
    pub dots: Option<bool>,
    pub patches: Option<bool>,
    pub photon_noise_iso: f32,
    pub resampling: i8,
    pub use_container: bool,
    pub codestream_level: i8,
    pub extra_int_options: Vec<(i32, i64)>,
    pub extra_float_options: Vec<(i32, f32)>,
}

Configuration for the libjxl JPEG XL encoder (the reference encoder).

Unlike the zune-jpegxl default (ZuneJxlEncodeConfig), libjxl honours 8- and 16-bit output, mathematically lossless encoding, and the full set of JxlEncoderFrameSettingId toggles. Requires the jxl-encode-libjxl feature.

Integer fields default to a -1 sentinel and Option fields to None, meaning “leave at libjxl’s own default”. This is a plain struct (not #[non_exhaustive]): construct it with a struct literal plus ..Default::default(). The two extra_*_options vectors are escape hatches that pass raw frame-setting ids through verbatim, so every libjxl toggle is reachable even if it has no dedicated field.

Fields

common: CommonEncodeOptions

Encoder-agnostic options. libjxl honours BitDepth::Eight and BitDepth::Sixteen.

distance: f32

Butteraugli distance: 0.0 is mathematically lossless, 1.0 visually lossless, up to 25.0 (smaller files, monotonic). Ignored when quality is Some or lossless is true.

quality: Option<f32>

Optional JPEG-style quality, 0.0..=100.0. When Some, libjxl converts it to a distance and it overrides distance.

lossless: bool

Force bit-exact lossless encoding (overrides distance/quality).

effort: u8

Effort / speed-quality trade-off, 1 (fastest) ..= 10 (slowest, best).

brotli_effort: i8

Brotli effort for the metadata/modular streams, -1 (default) or 0..=11.

decoding_speed: u8

Decoder-speed tier the stream is optimised for, 0 (default, best) ..= 4.

progressive: bool

Emit a responsive / progressive stream (sets RESPONSIVE + PROGRESSIVE_DC).

modular: LibjxlModular

Modular vs VarDCT mode.

color_transform: LibjxlColorTransform

Internal color transform.

epf: i8

Edge-preserving filter strength, -1 (default) ..= 3.

gaborish: Option<bool>

Gaborish deblocking filter: None = default, Some(false)/Some(true) = off/on.

noise: Option<bool>

Adaptive noise synthesis: None = default, Some(false)/Some(true) = off/on.

dots: Option<bool>

Dots synthesis: None = default, Some(false)/Some(true) = off/on.

patches: Option<bool>

Patches synthesis: None = default, Some(false)/Some(true) = off/on.

photon_noise_iso: f32

Photon-noise simulation strength in ISO units (0.0 = off).

resampling: i8

Downsampling factor, -1 (default), 1, 2, 4, or 8.

use_container: bool

Force the BMFF container even when a bare codestream would do.

codestream_level: i8

JPEG XL codestream feature level: -1 (auto), 5, or 10.

extra_int_options: Vec<(i32, i64)>

Escape hatch: raw (JxlEncoderFrameSettingId, value) integer settings applied verbatim, for any toggle without a dedicated field above.

extra_float_options: Vec<(i32, f32)>

Escape hatch: raw (JxlEncoderFrameSettingId, value) float settings.

Trait Implementations

impl Clone for LibjxlEncodeConfig

fn clone(&self) -> LibjxlEncodeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LibjxlEncodeConfig

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

Formats the value using the given formatter.

impl Default for LibjxlEncodeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LibjxlEncodeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LibjxlEncodeConfig

fn eq(&self, other: &LibjxlEncodeConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LibjxlEncodeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LibjxlEncodeConfig