ktx2-reader 0.1.2

Asynchronously read, validate and parse KTX v.2 texture files
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
96

use std::error::Error;
use std::{fmt, io};

/// Error while reading data.
#[derive(Debug)]
pub enum ReadError {
    IoError(io::Error),
    ParseError(ParseError),
}

impl Error for ReadError {}

impl fmt::Display for ReadError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match &self {
            ReadError::IoError(e) => write!(f, "Input error: {}", e),
            ReadError::ParseError(e) => write!(f, "Parse error: {}", e),
        }
    }
}

impl From<io::Error> for ReadError {
    fn from(e: io::Error) -> Self {
        Self::IoError(e)
    }
}

impl From<ParseError> for ReadError {
    fn from(e: ParseError) -> Self {
        Self::ParseError(e)
    }
}

/// Error, that happend when data doesn't satisfy expected parameters.
#[derive(Debug)]
pub enum ParseError {
    /// Unexpected texture identifier.
    BadIdentifier([u8; 12]),
    /// Specified format is not supported.
    BadFormat(u32),
    /// Type size of texture is zero.
    ZeroTypeSize,
    /// Width of texture is zero.
    ZeroWidth,
    /// Face count of texture is zero.
    ZeroFaceCount,
    /// Found unsupported feature.
    UnsupportedFeature(&'static str),
}

impl Error for ParseError {}

impl fmt::Display for ParseError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match &self {
            ParseError::BadIdentifier(id) => write!(f, "Identifier is wrong: {:?}", id),
            ParseError::BadFormat(i) => write!(f, "Unsoperted format: {:?}", i),
            ParseError::ZeroTypeSize => write!(f, "Type size is zero"),
            ParseError::ZeroWidth => write!(f, "Width is zero"),
            ParseError::ZeroFaceCount => write!(f, "Face count is zero"),
            ParseError::UnsupportedFeature(name) => write!(f, "Loader doesn't support: {}", name),
        }
    }
}

/// Error, that happened when reader can't read data to client's buffer.
#[derive(Debug)]
pub enum ReadToError {
    ReadError(ReadError),
    BadBuffer(u64),
}

impl Error for ReadToError {}

impl fmt::Display for ReadToError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match &self {
            Self::ReadError(e) => e.fmt(f),
            Self::BadBuffer(expect_size) => {
                write!(f, "Wrong buffer size. Expected: {:?}", expect_size)
            }
        }
    }
}

impl From<ReadError> for ReadToError {
    fn from(e: ReadError) -> Self {
        Self::ReadError(e)
    }
}

impl From<io::Error> for ReadToError {
    fn from(e: io::Error) -> Self {
        ReadError::IoError(e).into()
    }
}