load_image 3.5.0-beta.1

Load PNG or JPEG with color profile support
Documentation 
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

#![doc = include_str!("../README.md")]

mod alpha;
mod convert;
mod endian;
mod error;
mod format;
mod image;
mod loader;
mod pixel_format;
mod png;

pub use crate::error::*;

#[cfg(feature = "mozjpeg")]
mod mozjpeg;
#[cfg(all(not(feature = "mozjpeg"), feature = "jpeg"))]
mod jpeg;
#[cfg(any(feature = "mozjpeg", feature = "jpeg"))]
mod exif;
mod profiles;

#[cfg_attr(feature = "lcms2", path = "lcms.rs")]
mod cms;

#[cfg(feature = "avif")]
mod avif;

#[cfg(feature = "webp")]
mod webp;

pub use crate::convert::FromOptions;
pub use crate::format::*;
pub use crate::image::*;
pub use crate::loader::*;
use std::path::Path;

/// Load image from file path. Use [`Loader`] to configure it.
///
/// Pixels will be in sRGB color space. To load `DisplayP3` or other, use [`Loader`].
pub fn load_path(path: impl AsRef<Path>) -> Result<Image, Error> {
    Loader::new().load_path(path)
}

/// Load image from file data in memory. Use [`Loader`] to configure it.
pub fn load_data(data: &[u8]) -> Result<Image, Error> {
    Loader::new().load_data(data)
}

#[doc(hidden)]
#[deprecated(note = "use load_path or Loader::new()")]
pub fn load_image(path: impl AsRef<Path>, opaque: bool) -> Result<Image, Error> {
    Loader::new().opaque(opaque).load_path(path)
}

#[doc(hidden)]
#[deprecated(note = "use load_data or Loader::new()")]
pub fn load_image_data(data: &[u8], opaque: bool) -> Result<Image, Error> {
    Loader::new().opaque(opaque).load_data(data)
}

/// Re-export of related crates
pub mod export {
    /// Re-export of the [`rgb`](https://lib.rs/crates/rgb) crate
    pub mod rgb {
        pub use ::rgb::*;
        pub type GRAY16 = ::rgb::Gray<u16>;
        pub type GRAY8 = ::rgb::Gray<u8>;
        pub type GRAYA16 = ::rgb::GrayAlpha<u16>;
        pub type GRAYA8 = ::rgb::GrayAlpha<u8>;
    }

    /// Re-export of the [`imgref`](https://lib.rs/crates/imgref) crate
    pub mod imgref {
        use super::rgb;
        pub use imgref::{ImgRef, ImgVec};

        #[derive(Debug, Clone, PartialEq, Eq)]
        pub enum ImgRefKind<'data> {
            RGB8(ImgRef<'data, rgb::Rgb<u8>>),
            RGBA8(ImgRef<'data, rgb::Rgba<u8>>),
            RGB16(ImgRef<'data, rgb::Rgb<u16>>),
            RGBA16(ImgRef<'data, rgb::Rgba<u16>>),
            GRAY8(ImgRef<'data, rgb::Gray<u8>>),
            GRAY16(ImgRef<'data, rgb::Gray<u16>>),
            GRAYA8(ImgRef<'data, rgb::GrayAlpha<u8>>),
            GRAYA16(ImgRef<'data, rgb::GrayAlpha<u16>>),
        }

        #[derive(Debug, Clone, PartialEq, Eq)]
        pub enum ImgVecKind {
            RGB8(ImgVec<rgb::Rgb<u8>>),
            RGBA8(ImgVec<rgb::Rgba<u8>>),
            RGB16(ImgVec<rgb::Rgb<u16>>),
            RGBA16(ImgVec<rgb::Rgba<u16>>),
            GRAY8(ImgVec<rgb::Gray<u8>>),
            GRAY16(ImgVec<rgb::Gray<u16>>),
            GRAYA8(ImgVec<rgb::GrayAlpha<u8>>),
            GRAYA16(ImgVec<rgb::GrayAlpha<u16>>),
        }
    }
}