zentiff 0.1.0

TIFF decoding and encoding wrapper with zenpixels integration
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

//! TIFF error types.

use alloc::string::String;

/// Errors from TIFF encode/decode operations.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum TiffError {
    /// TIFF decoding error from the underlying tiff crate.
    #[error("TIFF decode error: {0}")]
    Decode(String),

    /// TIFF encoding error from the underlying tiff crate.
    #[error("TIFF encode error: {0}")]
    Encode(String),

    /// Invalid input (dimensions, buffer size, pixel format, etc.).
    #[error("invalid input: {0}")]
    InvalidInput(String),

    /// Unsupported TIFF feature (color type, compression, etc.).
    #[error("unsupported: {0}")]
    Unsupported(String),

    /// Resource limit exceeded.
    #[error("limit exceeded: {0}")]
    LimitExceeded(String),

    /// Operation stopped by cooperative cancellation.
    #[error("stopped: {0}")]
    Stopped(enough::StopReason),

    /// I/O error.
    #[error("I/O error: {0}")]
    Io(std::io::Error),

    /// Pixel buffer error.
    #[error("buffer error: {0}")]
    Buffer(zenpixels::BufferError),
}

impl From<enough::StopReason> for TiffError {
    fn from(reason: enough::StopReason) -> Self {
        TiffError::Stopped(reason)
    }
}

impl From<tiff::TiffError> for TiffError {
    fn from(e: tiff::TiffError) -> Self {
        match e {
            tiff::TiffError::FormatError(ref fe) => {
                TiffError::Decode(alloc::format!("format error: {fe}"))
            }
            tiff::TiffError::UnsupportedError(ref ue) => {
                TiffError::Unsupported(alloc::format!("{ue}"))
            }
            tiff::TiffError::IoError(io) => TiffError::Io(io),
            tiff::TiffError::LimitsExceeded => {
                TiffError::LimitExceeded("tiff decoder limits exceeded".into())
            }
            tiff::TiffError::IntSizeError => {
                TiffError::LimitExceeded("image dimensions exceed platform limits".into())
            }
            tiff::TiffError::UsageError(ref ue) => {
                TiffError::InvalidInput(alloc::format!("usage error: {ue}"))
            }
        }
    }
}

impl From<zenpixels::BufferError> for TiffError {
    fn from(e: zenpixels::BufferError) -> Self {
        TiffError::Buffer(e)
    }
}

impl From<whereat::At<zenpixels::BufferError>> for TiffError {
    fn from(e: whereat::At<zenpixels::BufferError>) -> Self {
        TiffError::Buffer(e.decompose().0)
    }
}

#[cfg(feature = "zencodec")]
impl From<zencodec::UnsupportedOperation> for TiffError {
    fn from(op: zencodec::UnsupportedOperation) -> Self {
        TiffError::Unsupported(alloc::format!("{op}"))
    }
}

/// Result type alias for zentiff operations with location tracking.
pub type Result<T> = core::result::Result<T, whereat::At<TiffError>>;