oxihuman-export 0.1.2

Export pipeline for OxiHuman — glTF, COLLADA, STL, and streaming formats
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

#![allow(dead_code)]
//! Export vertex stream data.

/// Vertex stream export data.
#[allow(dead_code)]
#[derive(Debug, Clone, PartialEq)]
pub struct VertexStreamExport {
    pub streams: Vec<StreamInfo>,
}

/// A single stream info.
#[allow(dead_code)]
#[derive(Debug, Clone, PartialEq)]
pub struct StreamInfo {
    pub semantic: String,
    pub components: u32,
    pub stride: u32,
    pub data: Vec<u8>,
}

/// Export vertex streams.
#[allow(dead_code)]
pub fn export_vertex_stream(streams: Vec<StreamInfo>) -> VertexStreamExport {
    VertexStreamExport { streams }
}

/// Return stream count.
#[allow(dead_code)]
pub fn stream_count(exp: &VertexStreamExport) -> usize {
    exp.streams.len()
}

/// Return stride for a stream.
#[allow(dead_code)]
pub fn stream_stride(exp: &VertexStreamExport, index: usize) -> u32 {
    if index < exp.streams.len() {
        exp.streams[index].stride
    } else {
        0
    }
}

/// Return data bytes for a stream.
#[allow(dead_code)]
pub fn stream_to_bytes(exp: &VertexStreamExport, index: usize) -> &[u8] {
    if index < exp.streams.len() {
        &exp.streams[index].data
    } else {
        &[]
    }
}

/// Return semantic for a stream.
#[allow(dead_code)]
pub fn stream_semantic(exp: &VertexStreamExport, index: usize) -> &str {
    if index < exp.streams.len() {
        &exp.streams[index].semantic
    } else {
        ""
    }
}

/// Return component count for a stream.
#[allow(dead_code)]
pub fn stream_component_count(exp: &VertexStreamExport, index: usize) -> u32 {
    if index < exp.streams.len() {
        exp.streams[index].components
    } else {
        0
    }
}

/// Compute total export size.
#[allow(dead_code)]
pub fn stream_export_size(exp: &VertexStreamExport) -> usize {
    exp.streams.iter().map(|s| s.data.len()).sum()
}

/// Validate vertex streams.
#[allow(dead_code)]
pub fn validate_vertex_stream(exp: &VertexStreamExport) -> bool {
    !exp.streams.is_empty()
        && exp.streams.iter().all(|s| !s.semantic.is_empty() && s.components > 0)
}

#[cfg(test)]
mod tests {
    use super::*;

    fn sample_stream() -> StreamInfo {
        StreamInfo {
            semantic: "POSITION".to_string(),
            components: 3,
            stride: 12,
            data: vec![0u8; 36],
        }
    }

    #[test]
    fn test_export_vertex_stream() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_count(&e), 1);
    }

    #[test]
    fn test_stream_stride() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_stride(&e, 0), 12);
    }

    #[test]
    fn test_stream_stride_oob() {
        let e = export_vertex_stream(vec![]);
        assert_eq!(stream_stride(&e, 0), 0);
    }

    #[test]
    fn test_stream_to_bytes() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_to_bytes(&e, 0).len(), 36);
    }

    #[test]
    fn test_stream_semantic() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_semantic(&e, 0), "POSITION");
    }

    #[test]
    fn test_stream_component_count() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_component_count(&e, 0), 3);
    }

    #[test]
    fn test_stream_export_size() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert_eq!(stream_export_size(&e), 36);
    }

    #[test]
    fn test_validate_vertex_stream() {
        let e = export_vertex_stream(vec![sample_stream()]);
        assert!(validate_vertex_stream(&e));
    }

    #[test]
    fn test_validate_empty() {
        let e = export_vertex_stream(vec![]);
        assert!(!validate_vertex_stream(&e));
    }

    #[test]
    fn test_stream_semantic_oob() {
        let e = export_vertex_stream(vec![]);
        assert_eq!(stream_semantic(&e, 0), "");
    }
}