geonative-image 0.3.0

Pure-Rust reader for image + world-file rasters (JPG/PNG with .jgw/.pgw sidecars) for the geonative geospatial library
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

//! Per-crate error type. Wraps the underlying decoder errors plus the
//! sidecar / format failure modes.

use thiserror::Error;

pub type Result<T> = std::result::Result<T, ImageError>;

#[derive(Debug, Error)]
pub enum ImageError {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("JPEG decode: {0}")]
    Jpeg(String),

    #[error("PNG decode: {0}")]
    Png(String),

    #[error("missing world file: expected {expected} next to image {image}")]
    MissingWorldFile { image: String, expected: String },

    #[error("world file parse: {0}")]
    WorldFile(String),

    #[error("unsupported image feature: {0}")]
    Unsupported(String),

    #[error("malformed input: {0}")]
    Malformed(String),
}

impl ImageError {
    pub fn malformed(msg: impl Into<String>) -> Self {
        Self::Malformed(msg.into())
    }

    pub fn unsupported(msg: impl Into<String>) -> Self {
        Self::Unsupported(msg.into())
    }

    pub fn world_file(msg: impl Into<String>) -> Self {
        Self::WorldFile(msg.into())
    }
}

impl From<ImageError> for geonative_core::Error {
    fn from(e: ImageError) -> Self {
        match e {
            ImageError::Io(io) => geonative_core::Error::Io(io),
            ImageError::Unsupported(s) => geonative_core::Error::unsupported(s),
            other => geonative_core::Error::malformed(other.to_string()),
        }
    }
}