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

#![allow(dead_code)]
// Copyright (C) 2026 COOLJAPAN OU (Team KitaSan)
// SPDX-License-Identifier: Apache-2.0

/// A stub thumbnail export (no actual rendering).
#[allow(dead_code)]
#[derive(Debug, Clone)]
pub struct ThumbnailExport {
    pub width: u32,
    pub height: u32,
    /// RGBA pixel data.
    pub pixels: Vec<u8>,
}

/// Create a stub thumbnail filled with a solid color.
#[allow(dead_code)]
pub fn export_thumbnail_stub(width: u32, height: u32, r: u8, g: u8, b: u8, a: u8) -> ThumbnailExport {
    let count = (width * height) as usize;
    let mut pixels = Vec::with_capacity(count * 4);
    for _ in 0..count {
        pixels.push(r);
        pixels.push(g);
        pixels.push(b);
        pixels.push(a);
    }
    ThumbnailExport { width, height, pixels }
}

/// Return the thumbnail width.
#[allow(dead_code)]
pub fn thumbnail_width(t: &ThumbnailExport) -> u32 {
    t.width
}

/// Return the thumbnail height.
#[allow(dead_code)]
pub fn thumbnail_height(t: &ThumbnailExport) -> u32 {
    t.height
}

/// Return the total pixel count.
#[allow(dead_code)]
pub fn thumbnail_pixel_count(t: &ThumbnailExport) -> u32 {
    t.width * t.height
}

/// Return a clone of the RGBA data.
#[allow(dead_code)]
pub fn thumbnail_to_rgba(t: &ThumbnailExport) -> Vec<u8> {
    t.pixels.clone()
}

/// Convert to grayscale (single channel).
#[allow(dead_code)]
pub fn thumbnail_to_grayscale(t: &ThumbnailExport) -> Vec<u8> {
    let count = (t.width * t.height) as usize;
    let mut gray = Vec::with_capacity(count);
    for i in 0..count {
        let r = t.pixels[i * 4] as f32;
        let g = t.pixels[i * 4 + 1] as f32;
        let b = t.pixels[i * 4 + 2] as f32;
        gray.push((0.299 * r + 0.587 * g + 0.114 * b) as u8);
    }
    gray
}

/// Return the aspect ratio (width / height).
#[allow(dead_code)]
pub fn thumbnail_aspect_ratio(t: &ThumbnailExport) -> f32 {
    if t.height == 0 {
        return 0.0;
    }
    t.width as f32 / t.height as f32
}

/// Return the byte size of the RGBA export.
#[allow(dead_code)]
pub fn thumbnail_export_size(t: &ThumbnailExport) -> usize {
    t.pixels.len()
}

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

    fn sample() -> ThumbnailExport {
        export_thumbnail_stub(4, 2, 128, 64, 32, 255)
    }

    #[test]
    fn test_stub_creation() {
        let t = sample();
        assert_eq!(t.width, 4);
        assert_eq!(t.height, 2);
    }

    #[test]
    fn test_width() {
        assert_eq!(thumbnail_width(&sample()), 4);
    }

    #[test]
    fn test_height() {
        assert_eq!(thumbnail_height(&sample()), 2);
    }

    #[test]
    fn test_pixel_count() {
        assert_eq!(thumbnail_pixel_count(&sample()), 8);
    }

    #[test]
    fn test_to_rgba() {
        let rgba = thumbnail_to_rgba(&sample());
        assert_eq!(rgba.len(), 32); // 4*2*4
        assert_eq!(rgba[0], 128);
    }

    #[test]
    fn test_to_grayscale() {
        let g = thumbnail_to_grayscale(&sample());
        assert_eq!(g.len(), 8);
        assert!(g[0] > 0);
    }

    #[test]
    fn test_aspect_ratio() {
        let ar = thumbnail_aspect_ratio(&sample());
        assert!((ar - 2.0).abs() < 1e-5);
    }

    #[test]
    fn test_export_size() {
        assert_eq!(thumbnail_export_size(&sample()), 32);
    }

    #[test]
    fn test_square() {
        let t = export_thumbnail_stub(8, 8, 0, 0, 0, 255);
        assert!((thumbnail_aspect_ratio(&t) - 1.0).abs() < 1e-5);
    }

    #[test]
    fn test_zero_height() {
        let t = ThumbnailExport { width: 4, height: 0, pixels: vec![] };
        assert!((thumbnail_aspect_ratio(&t)).abs() < 1e-5);
    }
}