Enum EncodeOptions 

#[non_exhaustive]
pub enum EncodeOptions {
    PngZune(ZunePngEncodeConfig),
    JpegJpegEnc(JpegEncEncodeConfig),
    WebpLibwebp(LibwebpEncodeConfig),
    AvifRavif(RavifEncodeConfig),
    JxlZune(ZuneJxlEncodeConfig),
    Dng(DngExportConfig),
}

Selects the encoder implementation and carries its configuration.

Obtain one with EncodeOptions::default_for for a format’s default backend, or with a constructor such as EncodeOptions::jpeg, or by naming a variant directly to pin a specific backend.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PngZune(ZunePngEncodeConfig)

PNG via zune-png (requires png-encode).

JpegJpegEnc(JpegEncEncodeConfig)

JPEG via the pure-Rust jpeg-encoder (requires jpeg-encode).

WebpLibwebp(LibwebpEncodeConfig)

WebP via libwebp (requires webp-encode).

AvifRavif(RavifEncodeConfig)

AVIF via ravif / rav1e (requires avif-encode).

JxlZune(ZuneJxlEncodeConfig)

JPEG XL via zune-jpegxl (requires jxl-encode).

Dng(DngExportConfig)

DNG via the in-repo encoder (requires dng-encode).

Implementations

impl EncodeOptions

pub fn png() -> Self

PNG with default configuration.

pub fn jpeg() -> Self

JPEG with default configuration.

pub fn webp_lossy() -> Self

Lossy WebP with default configuration.

pub fn webp_lossless() -> Self

Lossless WebP with default configuration.

pub fn avif() -> Self

AVIF with default configuration.

pub fn jxl() -> Self

JPEG XL with default configuration.

pub fn dng() -> Self

DNG with default configuration.

pub fn format(&self) -> OutputFormat

The output format this encoder produces.

pub fn codec_id(&self) -> CodecId

The stable identifier of the selected encoder implementation.

pub fn common(&self) -> CommonEncodeOptions

The encoder-agnostic options (metadata embedding, bit depth) in effect.

For DNG — which has its own configuration shape — a CommonEncodeOptions is synthesised from DngExportConfig.

pub fn default_for(format: StandardFormat) -> Option<EncodeOptions>

The default encoder backend for format, with default configuration.

Returns None when no encoder for format is compiled in, or when the format has no encoder. DNG is absent — it is not a StandardFormat; use EncodeOptions::dng.

Trait Implementations

impl Clone for EncodeOptions

fn clone(&self) -> EncodeOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EncodeOptions

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

Formats the value using the given formatter.

impl Default for EncodeOptions

Available on crate feature png-encode only.

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EncodeOptions

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EncodeOptions

fn eq(&self, other: &EncodeOptions) -> 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 EncodeOptions

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 EncodeOptions