Enum DecodedImage 

#[non_exhaustive]
pub enum DecodedImage {
    Png(PngDecoded),
    Jpeg(JpegDecoded),
    Bmp(BmpDecoded),
}

Universal decoded image — union of all per-codec decoded structs.

This enum is #[non_exhaustive] because new codecs (e.g. WebP) may be added over time. Users should include a wildcard arm when matching.

Each variant wraps the per-codec decoded struct (e.g. png::PngDecoded), which itself contains the pixel data and ancillary metadata. This means load() always gives you metadata for free — no separate “with metadata” function needed.

Per-codec pixel enums (e.g. png::PngImage) are not #[non_exhaustive] — they are exhaustive spec sheets. If you know the format, prefer decoding with the per-codec API directly; you get exhaustive matching and avoid the wildcard arm.

Examples

let bytes = std::fs::read("image.png").unwrap();
match load(&bytes).unwrap() {
    #[cfg(feature = "png")]
    DecodedImage::Png(decoded) => {
        // `decoded.image` is a `PngImage` — match exhaustively
        // `decoded.metadata` carries colour-space info, text chunks, etc.
    }
    _ => { /* unknown or unsupported codec */ }
}

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.

Png(PngDecoded)

Available on crate feature png only.

A decoded PNG file — pixel data + metadata. Only available with the png feature.

Jpeg(JpegDecoded)

Available on crate feature jpeg only.

A decoded JPEG file — pixel data + metadata. Only available with the jpeg feature.

Bmp(BmpDecoded)

Available on crate feature bmp only.

A decoded BMP file — pixel data + metadata. Only available with the bmp feature.