oximedia-transcode 0.1.3

High-level transcoding pipeline for OxiMedia
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
159
160

//! Archive and preservation presets for long-term storage.

use crate::{PresetConfig, QualityMode};

/// Lossless archival preset using VP9 (best compression).
///
/// Note: In a real implementation, this would use FFV1 for true lossless.
/// VP9 lossless mode is used here as it's part of our royalty-free codec set.
#[must_use]
pub fn lossless_vp9() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: None, // Lossless mode
        audio_bitrate: Some(256_000),
        width: None,      // Preserve source resolution
        height: None,     // Preserve source resolution
        frame_rate: None, // Preserve source frame rate
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// High-quality archival preset (VP9, near-lossless).
#[must_use]
pub fn high_quality_vp9() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(50_000_000), // 50 Mbps
        audio_bitrate: Some(256_000),
        width: None,      // Preserve source
        height: None,     // Preserve source
        frame_rate: None, // Preserve source
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// High-quality archival preset (AV1, smaller file size).
#[must_use]
pub fn high_quality_av1() -> PresetConfig {
    PresetConfig {
        video_codec: Some("av1".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(30_000_000), // 30 Mbps (AV1 more efficient)
        audio_bitrate: Some(256_000),
        width: None,
        height: None,
        frame_rate: None,
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// Master archival preset (highest quality).
#[must_use]
pub fn master_archive() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(100_000_000), // 100 Mbps
        audio_bitrate: Some(512_000),     // High-quality audio
        width: None,
        height: None,
        frame_rate: None,
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// Intermediate archival preset (balance of quality and size).
#[must_use]
pub fn intermediate_archive() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(25_000_000), // 25 Mbps
        audio_bitrate: Some(192_000),
        width: None,
        height: None,
        frame_rate: None,
        quality_mode: Some(QualityMode::High),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// Preservation preset with metadata (1080p).
#[must_use]
pub fn preservation_1080p() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(20_000_000), // 20 Mbps
        audio_bitrate: Some(256_000),
        width: Some(1920),
        height: Some(1080),
        frame_rate: Some((24, 1)), // Film standard
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

/// Preservation preset with metadata (4K).
#[must_use]
pub fn preservation_4k() -> PresetConfig {
    PresetConfig {
        video_codec: Some("vp9".to_string()),
        audio_codec: Some("opus".to_string()),
        video_bitrate: Some(60_000_000), // 60 Mbps
        audio_bitrate: Some(320_000),
        width: Some(3840),
        height: Some(2160),
        frame_rate: Some((24, 1)),
        quality_mode: Some(QualityMode::VeryHigh),
        container: Some("mkv".to_string()),
        audio_channel_layout: None,
    }
}

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

    #[test]
    fn test_lossless_vp9() {
        let preset = lossless_vp9();
        assert_eq!(preset.video_codec, Some("vp9".to_string()));
        assert_eq!(preset.container, Some("mkv".to_string()));
        assert!(preset.width.is_none()); // Preserve source
    }

    #[test]
    fn test_high_quality_av1() {
        let preset = high_quality_av1();
        assert_eq!(preset.video_codec, Some("av1".to_string()));
        assert_eq!(preset.quality_mode, Some(QualityMode::VeryHigh));
    }

    #[test]
    fn test_master_archive() {
        let preset = master_archive();
        assert_eq!(preset.video_bitrate, Some(100_000_000));
        assert_eq!(preset.audio_bitrate, Some(512_000));
    }

    #[test]
    fn test_preservation_4k() {
        let preset = preservation_4k();
        assert_eq!(preset.width, Some(3840));
        assert_eq!(preset.height, Some(2160));
        assert_eq!(preset.frame_rate, Some((24, 1)));
    }
}