wow-m2 0.6.2

Parser, validator, and converter for World of Warcraft M2 model files with animation support
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

use std::io;
use thiserror::Error;

use crate::anim::AnimFormat;

/// Error types for M2 model parsing and processing
#[derive(Error, Debug)]
pub enum M2Error {
    /// I/O Error during reading or writing
    #[error("I/O error: {0}")]
    Io(#[from] io::Error),

    /// Invalid magic number in the file header
    #[error("Invalid magic number: expected '{expected}', got '{actual}'")]
    InvalidMagic { expected: String, actual: String },

    /// Unsupported file version
    #[error("Unsupported version: {0}")]
    UnsupportedVersion(String),

    /// Error during parsing
    #[error("Parse error: {0}")]
    ParseError(String),

    /// Error during validation
    #[error("Validation error: {0}")]
    ValidationError(String),

    /// Error during version conversion
    #[error("Conversion error: cannot convert from version {from} to {to}: {reason}")]
    ConversionError { from: u32, to: u32, reason: String },

    /// Chunk error: missing expected chunk or invalid chunk
    #[error("Chunk error: {0}")]
    ChunkError(String),

    /// Reference error: invalid reference in the file
    #[error("Reference error: {0}")]
    ReferenceError(String),

    /// Internal error: something went wrong in the parser logic
    #[error("Internal error: {0}")]
    InternalError(String),

    /// ANIM format detection failed
    #[error("ANIM format detection failed: {0}")]
    AnimFormatError(String),

    /// Legacy ANIM parsing error
    #[error("Legacy ANIM parsing error: {0}")]
    LegacyAnimError(String),

    /// ANIM format conversion error
    #[error("ANIM format conversion error: from {from:?} to {to:?}: {reason}")]
    AnimConversionError {
        from: AnimFormat,
        to: AnimFormat,
        reason: String,
    },

    /// Invalid magic bytes in chunked format
    #[error("Invalid magic bytes: {0:?}")]
    InvalidMagicBytes([u8; 4]),

    /// Missing required MD21 chunk
    #[error("Missing required MD21 chunk")]
    MissingMD21Chunk,

    /// Malformed chunk header
    #[error("Malformed chunk header")]
    MalformedChunk,

    /// Unknown FileDataID
    #[error("Unknown FileDataID: {0}")]
    UnknownFileDataId(u32),

    /// Failed to resolve external file
    #[error("Failed to resolve external file: {0}")]
    ExternalFileError(String),
}

/// Result type using M2Error
pub type Result<T> = std::result::Result<T, M2Error>;