zenwebp 0.4.4

High-performance WebP encoding and decoding in pure Rust
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

//! Error types for mux/demux operations.

use alloc::string::String;
use thiserror::Error;

use crate::decoder::DecodeError;
use crate::encoder::EncodeError;

/// Result type alias using `At<MuxError>` for automatic location tracking.
pub type MuxResult<T> = core::result::Result<T, whereat::At<MuxError>>;

impl From<whereat::At<MuxError>> for MuxError {
    fn from(at: whereat::At<MuxError>) -> Self {
        at.decompose().0
    }
}

impl From<whereat::At<EncodeError>> for MuxError {
    fn from(at: whereat::At<EncodeError>) -> Self {
        Self::EncodeError(at.decompose().0)
    }
}

impl From<whereat::At<DecodeError>> for MuxError {
    fn from(at: whereat::At<DecodeError>) -> Self {
        Self::DecodeError(at.decompose().0)
    }
}

/// Errors that can occur during mux/demux operations.
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum MuxError {
    /// The data is not a valid WebP file.
    #[error("Invalid WebP format: {0}")]
    InvalidFormat(String),

    /// Frame dimensions are invalid (zero, too large, or don't fit the canvas).
    #[error("Invalid dimensions: {width}x{height}")]
    InvalidDimensions {
        /// The invalid width.
        width: u32,
        /// The invalid height.
        height: u32,
    },

    /// A frame index is out of bounds.
    #[error("Frame {index} out of bounds (total: {total})")]
    FrameOutOfBounds {
        /// The requested frame index.
        index: u32,
        /// The total number of frames.
        total: u32,
    },

    /// An error occurred during encoding.
    #[error("Encoding error: {0}")]
    EncodeError(#[from] EncodeError),

    /// An error occurred during decoding/parsing.
    #[error("Decoding error: {0}")]
    DecodeError(#[from] DecodeError),

    /// No frames were added before assembly.
    #[error("No frames to assemble")]
    NoFrames,

    /// Frame offset is not a multiple of 2 (WebP spec requirement).
    #[error("Frame offset must be even: ({x}, {y})")]
    OddFrameOffset {
        /// The invalid x offset.
        x: u32,
        /// The invalid y offset.
        y: u32,
    },

    /// Frame extends beyond the canvas boundary.
    #[error(
        "Frame at ({x}, {y}) size {width}x{height} exceeds canvas {canvas_width}x{canvas_height}"
    )]
    FrameOutsideCanvas {
        /// Frame x offset.
        x: u32,
        /// Frame y offset.
        y: u32,
        /// Frame width.
        width: u32,
        /// Frame height.
        height: u32,
        /// Canvas width.
        canvas_width: u32,
        /// Canvas height.
        canvas_height: u32,
    },
}