fbxcel 0.9.0

Excellent FBX library
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
97
98
99

//! Data error.
//!
//! This is mainly syntax and low-level structure error.

use std::{error, fmt, string::FromUtf8Error};

/// Data error.
#[derive(Debug)]
#[non_exhaustive]
pub enum DataError {
    /// Data with broken compression.
    BrokenCompression(Compression, Box<dyn std::error::Error + Send + Sync>),
    /// FBX footer is broken.
    ///
    /// Detail is not available because the footer may contain variable length
    /// field, and it is hard to identify what is actually broken.
    BrokenFbxFooter,
    /// Got an unknown array attribute encoding.
    InvalidArrayAttributeEncoding(u32),
    /// Invalid node attribute type code.
    ///
    /// The `u8` is the code the parser got.
    InvalidAttributeTypeCode(u8),
    /// Invalid node name encoding.
    ///
    /// This error indicates that the node name is non-valid UTF-8.
    InvalidNodeNameEncoding(FromUtf8Error),
    /// Node attribute error.
    ///
    /// This error indicates that some error happened while reading node
    /// attributes.
    NodeAttributeError,
    /// Node length mismatch.
    ///
    /// This error indicates that a node ends at the position which differs from
    /// the offset declared at the header.
    ///
    /// The former `u64` is expected position, the latter `Option<u64>` is the
    /// actual position the node ends.
    /// If the error is detected before the node actually ends, the actual
    /// position will be `None`.
    NodeLengthMismatch(u64, Option<u64>),
    /// Unexpected attribute value or type.
    ///
    /// The former is the expected, the latter is a description of the actual value.
    UnexpectedAttribute(String, String),
}

impl error::Error for DataError {
    fn source(&self) -> Option<&(dyn error::Error + 'static)> {
        match self {
            DataError::BrokenCompression(_, e) => Some(e.as_ref()),
            DataError::InvalidNodeNameEncoding(e) => Some(e),
            _ => None,
        }
    }
}

impl fmt::Display for DataError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            DataError::BrokenFbxFooter => write!(f, "FBX footer is broken"),
            DataError::BrokenCompression(codec, e) => write!(
                f,
                "Data with broken compression (codec={:?}): {:?}",
                codec, e
            ),
            DataError::InvalidArrayAttributeEncoding(encoding) => {
                write!(f, "Unknown array attribute encoding: got {:?}", encoding)
            }
            DataError::InvalidAttributeTypeCode(code) => {
                write!(f, "Invalid node attribute type code: {:?}", code)
            }
            DataError::InvalidNodeNameEncoding(e) => {
                write!(f, "Invalid node name encoding: {:?}", e)
            }
            DataError::NodeAttributeError => {
                write!(f, "Some error occured while reading node attributes")
            }
            DataError::NodeLengthMismatch(expected, got) => write!(
                f,
                "Node ends with unexpected position: expected {}, got {:?}",
                expected, got
            ),
            DataError::UnexpectedAttribute(expected, got) => write!(
                f,
                "Unexpected attribute value or type: expected {}, got {}",
                expected, got
            ),
        }
    }
}

/// Compression format or algorithm.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Compression {
    /// ZLIB compression.
    Zlib,
}