ai-image 0.25.10

no_std fork of image — imaging library with basic image processing and encoders/decoders for common image formats.
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

//! Input and output of images.

#[cfg(any(feature = "tga", feature = "dds", feature = "bmp"))]
use alloc::vec::Vec;
#[cfg(any(feature = "tga", feature = "dds", feature = "bmp"))]
use no_std_io::io;

/// The decoder traits.
pub(crate) mod decoder;
/// The encoder traits.
pub(crate) mod encoder;

pub(crate) mod format;
pub(crate) mod free_functions;
#[cfg(feature = "std")]
pub(crate) mod image_reader_type;
pub(crate) mod limits;

#[cfg(feature = "std")]
#[deprecated(note = "this type has been moved and renamed to ai_image::ImageReader")]
/// Deprecated re-export of `ImageReader` as `Reader`
pub type Reader<R> = ImageReader<R>;
#[deprecated(note = "this type has been moved to ai_image::Limits")]
/// Deprecated re-export of `Limits`
pub type Limits = limits::Limits;
#[deprecated(note = "this type has been moved to ai_image::LimitSupport")]
/// Deprecated re-export of `LimitSupport`
pub type LimitSupport = limits::LimitSupport;

#[cfg(feature = "std")]
pub(crate) use self::image_reader_type::ImageReader;

/// Adds `read_exact_vec`
#[cfg(any(feature = "tga", feature = "dds", feature = "bmp"))]
pub(crate) trait ReadExt {
    fn read_exact_vec(&mut self, vec: &mut Vec<u8>, len: usize) -> io::Result<()>;
}

#[cfg(any(feature = "tga", feature = "dds", feature = "bmp"))]
impl<R: io::Read> ReadExt for R {
    fn read_exact_vec(&mut self, vec: &mut Vec<u8>, len: usize) -> io::Result<()> {
        let initial_len = vec.len();
        // no_std_io::Error doesn't provide other()
        #[allow(clippy::io_other_error)]
        vec.try_reserve(len)
            .map_err(|_| io::Error::new(io::ErrorKind::Other, "allocation failed"))?;
        vec.resize(initial_len + len, 0);
        match self.read_exact(&mut vec[initial_len..]) {
            Ok(()) => Ok(()),
            Err(e) => {
                vec.truncate(initial_len);
                Err(e)
            }
        }
    }
}