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

//! Errors that this crate can return.

use crate::prelude::*;
use std::{ffi::OsString, io};
use thiserror::Error;

/// The result type for [`Engine`] operations.
pub type Result<T> = anyhow::Result<T, anyhow::Error>;

/// The error type for [`Engine`] operations.
#[non_exhaustive]
#[derive(Debug, Error)]
pub enum Error {
    /// Invalid Texture ID. Texture either doesn't exist or was deleted.
    #[error("invalid texture id `{0}`")]
    InvalidTexture(TextureId),
    /// Invalid Window ID. Window either doesn't exist or was closed.
    #[error("invalid window id `{0}`")]
    InvalidWindow(WindowId),
    /// Hexadecimal [Color] string parsing error. String doesn't match any of `3`, `4`, `6`, or `8`
    /// digit hexadecimal (radix `16`) values with a leading `#` character.
    #[error("hexadecimal color string parsing error")]
    ParseColorError,
    /// Invalid [Color] slice. Slice length is not in the range `1..=4`.
    #[error("invalid color slice")]
    InvalidColorSlice,
    /// Invalid [Image]. `Image` data does not match it's dimensions based on [`PixelFormat`].
    #[error(
        "invalid image {{ width: {width}, height: {height}, size: {size}, format: {format:?} }}"
    )]
    InvalidImage {
        /// `Image` width.
        width: u32,
        /// `Image` height.
        height: u32,
        /// Size in bytes.
        size: usize,
        /// `Image` format.
        format: PixelFormat,
    },
    /// Unsupported [Image] format.
    #[error("unsupported image format {{ bit_depth: {bit_depth:?}, color_type: {color_type:?} }}")]
    UnsupportedImageFormat {
        /// `Image` [png::BitDepth].
        bit_depth: png::BitDepth,
        /// `Image` [png::ColorType].
        color_type: png::ColorType,
    },
    /// Unsupported file type.
    #[error("unsupported file type with extension `{0:?}`")]
    UnsupportedFileType(Option<OsString>),
    /// Graphics renderer error.
    #[error("renderer error: {0}")]
    Renderer(String),
    /// I/O errors.
    #[error(transparent)]
    Io(#[from] io::Error),
    /// Other, unspecified errors.
    #[error(transparent)]
    Other(#[from] anyhow::Error),
}