glycin-ng 0.2.2

Permissively-licensed Rust image decoder library with in-process sandboxing
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Format-specific decoders.
//!
//! Each decoder is gated by its Cargo feature and is wired into
//! [`dispatch`] once implemented. Formats whose feature is off return
//! [`Error::UnsupportedFormat`](crate::Error::UnsupportedFormat).

#[cfg(any(
    feature = "bmp",
    feature = "ico",
    feature = "tga",
    feature = "pnm",
    feature = "dds",
    feature = "exr",
))]
mod image_rs;

#[cfg(feature = "bmp")]
mod bmp;
#[cfg(feature = "dds")]
mod dds;
#[cfg(feature = "exr")]
mod exr;
#[cfg(feature = "gif")]
mod gif;
#[cfg(feature = "ico")]
mod ico;
#[cfg(feature = "jpeg")]
mod jpeg;
#[cfg(feature = "jxl")]
mod jxl;
#[cfg(feature = "png")]
mod png;
#[cfg(feature = "pnm")]
mod pnm;
#[cfg(feature = "qoi")]
mod qoi;
#[cfg(feature = "svg")]
mod svg;
#[cfg(feature = "tga")]
mod tga;
#[cfg(feature = "tiff")]
mod tiff;
#[cfg(feature = "webp")]
mod webp;

use crate::sniff::KnownFormat;
use crate::{Error, Image, Limits, Result};

/// Decoder input options shared across formats.
#[allow(dead_code)]
pub(crate) struct DecodeOptions {
    pub limits: Limits,
    pub apply_transformations: bool,
    /// Caller-requested output size for resolution-independent formats
    /// (SVG today). Raster decoders ignore this; gdk-pixbuf and GTK
    /// scale their bitmap output themselves.
    pub render_size_hint: Option<(u32, u32)>,
}

impl Default for DecodeOptions {
    fn default() -> Self {
        Self {
            limits: Limits::default(),
            apply_transformations: true,
            render_size_hint: None,
        }
    }
}

/// Route a sniffed format to its decoder.
pub(crate) fn dispatch(format: KnownFormat, bytes: &[u8], opts: &DecodeOptions) -> Result<Image> {
    match format {
        #[cfg(feature = "png")]
        KnownFormat::Png => png::decode(bytes, opts),
        #[cfg(feature = "jpeg")]
        KnownFormat::Jpeg => jpeg::decode(bytes, opts),
        #[cfg(feature = "gif")]
        KnownFormat::Gif => gif::decode(bytes, opts),
        #[cfg(feature = "webp")]
        KnownFormat::WebP => webp::decode(bytes, opts),
        #[cfg(feature = "tiff")]
        KnownFormat::Tiff => tiff::decode(bytes, opts),
        #[cfg(feature = "bmp")]
        KnownFormat::Bmp => bmp::decode(bytes, opts),
        #[cfg(feature = "ico")]
        KnownFormat::Ico => ico::decode(bytes, opts),
        #[cfg(feature = "tga")]
        KnownFormat::Tga => tga::decode(bytes, opts),
        #[cfg(feature = "qoi")]
        KnownFormat::Qoi => qoi::decode(bytes, opts),
        #[cfg(feature = "exr")]
        KnownFormat::Exr => exr::decode(bytes, opts),
        #[cfg(feature = "pnm")]
        KnownFormat::Pnm => pnm::decode(bytes, opts),
        #[cfg(feature = "dds")]
        KnownFormat::Dds => dds::decode(bytes, opts),
        #[cfg(feature = "jxl")]
        KnownFormat::Jxl => jxl::decode(bytes, opts),
        #[cfg(feature = "svg")]
        KnownFormat::Svg => svg::decode(bytes, opts),
        #[allow(unreachable_patterns)]
        _ => {
            let _ = (bytes, opts);
            Err(Error::UnsupportedFormat)
        }
    }
}