]>
Commit | Line | Data |
---|---|---|
1 | //! Global registry of codec information. | |
2 | //! | |
3 | //! This module contains codec information from technical level that allows user to retrieve information about codec type and features without creating and invoking a decoder for such codec. | |
4 | use std::fmt; | |
5 | ||
6 | /// Codec types. | |
7 | #[derive(Debug,Clone,Copy,PartialEq)] | |
8 | #[allow(dead_code)] | |
9 | pub enum CodecType { | |
10 | /// Video codec. | |
11 | Video, | |
12 | /// Audio codec. | |
13 | Audio, | |
14 | /// Subtitle codec. | |
15 | Subtitles, | |
16 | /// Some special codec (e.g. some event stream or separate timecodes stream). | |
17 | Data, | |
18 | /// Dummy codec. | |
19 | None, | |
20 | } | |
21 | ||
22 | impl fmt::Display for CodecType { | |
23 | fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { | |
24 | match *self { | |
25 | CodecType::Video => write!(f, "Video"), | |
26 | CodecType::Audio => write!(f, "Audio"), | |
27 | CodecType::Subtitles => write!(f, "Subtitles"), | |
28 | CodecType::Data => write!(f, "Data"), | |
29 | CodecType::None => write!(f, "-"), | |
30 | } | |
31 | } | |
32 | } | |
33 | ||
34 | const CODEC_CAP_INTRAONLY:u32 = 0x0001; | |
35 | const CODEC_CAP_LOSSLESS:u32 = 0x0002; | |
36 | const CODEC_CAP_REORDER:u32 = 0x0004; | |
37 | const CODEC_CAP_HYBRID:u32 = 0x0008; | |
38 | const CODEC_CAP_SCALABLE:u32 = 0x0010; | |
39 | ||
40 | /// Codec description structure. | |
41 | #[derive(Clone)] | |
42 | pub struct CodecDescription { | |
43 | /// Short codec name. | |
44 | /// | |
45 | /// Short codec name is used inside NihAV as the unique identifier. | |
46 | pub name: &'static str, | |
47 | /// Full codec name. | |
48 | pub fname: &'static str, | |
49 | /// Codec type. | |
50 | pub ctype: CodecType, | |
51 | /// Codec capabilities. | |
52 | pub caps: u32, | |
53 | } | |
54 | ||
55 | impl CodecDescription { | |
56 | /// Returns short codec name. | |
57 | pub fn get_name(&self) -> &'static str { self.name } | |
58 | /// Returns full codec name. | |
59 | pub fn get_full_name(&self) -> &'static str { self.fname } | |
60 | /// Returns codec type. | |
61 | pub fn get_codec_type(&self) -> CodecType { self.ctype } | |
62 | /// Reports whether the codec has only intra frames or not. | |
63 | pub fn is_intraonly(&self) -> bool { (self.caps & CODEC_CAP_INTRAONLY) != 0 } | |
64 | /// Reports whether the codec is lossless. | |
65 | pub fn is_lossless(&self) -> bool { (self.caps & CODEC_CAP_LOSSLESS) != 0 } | |
66 | /// Reports whether the codec requires frame reordering. | |
67 | pub fn has_reorder(&self) -> bool { (self.caps & CODEC_CAP_REORDER) != 0 } | |
68 | /// Reports whether the codec can be either lossless or lossy. | |
69 | pub fn is_hybrid(&self) -> bool { (self.caps & CODEC_CAP_HYBRID) != 0 } | |
70 | /// Reports whether codec supports scalability. | |
71 | /// | |
72 | /// Scalability means that codec can be decoded in reduced resolution by design. | |
73 | pub fn is_scalable(&self) -> bool { (self.caps & CODEC_CAP_SCALABLE) != 0 } | |
74 | } | |
75 | ||
76 | impl fmt::Display for CodecDescription { | |
77 | fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { | |
78 | let mut out = self.fname.to_string(); | |
79 | if self.caps != 0 { | |
80 | let mut capfmt = "".to_string(); | |
81 | if (self.caps & CODEC_CAP_INTRAONLY) != 0 { | |
82 | capfmt = format!("{} Intra-only", capfmt); | |
83 | } | |
84 | if (self.caps & CODEC_CAP_LOSSLESS) != 0 { | |
85 | capfmt = format!("{} Lossless", capfmt); | |
86 | } | |
87 | if (self.caps & CODEC_CAP_REORDER) != 0 { | |
88 | capfmt = format!("{} Frame reorder", capfmt); | |
89 | } | |
90 | if (self.caps & CODEC_CAP_HYBRID) != 0 { | |
91 | capfmt = format!("{} Can be lossy and lossless", capfmt); | |
92 | } | |
93 | if (self.caps & CODEC_CAP_SCALABLE) != 0 { | |
94 | capfmt = format!("{} Scalable", capfmt); | |
95 | } | |
96 | out = format!("{} ({})", out, capfmt); | |
97 | } | |
98 | write!(f, "{}", out) | |
99 | } | |
100 | } | |
101 | ||
102 | macro_rules! desc { | |
103 | (video; $n:expr, $fn:expr) => ({ | |
104 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
105 | caps: 0 } | |
106 | }); | |
107 | (video; $n:expr, $fn:expr, $c:expr) => ({ | |
108 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
109 | caps: $c } | |
110 | }); | |
111 | (video-ll; $n:expr, $fn:expr) => ({ | |
112 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
113 | caps: CODEC_CAP_LOSSLESS | CODEC_CAP_INTRAONLY } | |
114 | }); | |
115 | (video-llp; $n:expr, $fn:expr) => ({ | |
116 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
117 | caps: CODEC_CAP_LOSSLESS } | |
118 | }); | |
119 | (video-im; $n:expr, $fn:expr) => ({ | |
120 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
121 | caps: CODEC_CAP_INTRAONLY } | |
122 | }); | |
123 | (video-modern; $n:expr, $fn:expr) => ({ | |
124 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video, | |
125 | caps: CODEC_CAP_REORDER | CODEC_CAP_HYBRID } | |
126 | }); | |
127 | (audio; $n:expr, $fn:expr) => ({ | |
128 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Audio, | |
129 | caps: 0 } | |
130 | }); | |
131 | (audio-ll; $n:expr, $fn:expr) => ({ | |
132 | CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Audio, | |
133 | caps: CODEC_CAP_LOSSLESS | CODEC_CAP_INTRAONLY } | |
134 | }); | |
135 | } | |
136 | ||
137 | /// Returns codec description for the provided codec short name if it is found. | |
138 | pub fn get_codec_description(name: &str) -> Option<&'static CodecDescription> { | |
139 | for reg in CODEC_REGISTER { | |
140 | if reg.name == name { | |
141 | return Some(reg); | |
142 | } | |
143 | } | |
144 | None | |
145 | } | |
146 | ||
147 | static CODEC_REGISTER: &'static [CodecDescription] = &[ | |
148 | desc!(audio-ll; "pcm", "PCM"), | |
149 | ||
150 | desc!(video-im; "indeo1", "Intel Raw IF09"), | |
151 | desc!(video-im; "indeo2", "Intel Indeo 2"), | |
152 | desc!(video; "indeo3", "Intel Indeo 3"), | |
153 | desc!(video; "indeo4", "Intel Indeo 4", CODEC_CAP_REORDER | CODEC_CAP_SCALABLE), | |
154 | desc!(video; "indeo5", "Intel Indeo 5", CODEC_CAP_REORDER | CODEC_CAP_SCALABLE), | |
155 | desc!(video; "intel263", "Intel I263", CODEC_CAP_REORDER), | |
156 | desc!(audio; "iac", "Intel Indeo audio"), | |
157 | desc!(audio; "imc", "Intel Music Coder"), | |
158 | ||
159 | desc!(video; "realvideo1", "Real Video 1"), | |
160 | desc!(video; "realvideo2", "Real Video 2"), | |
161 | desc!(video; "realvideo3", "Real Video 3", CODEC_CAP_REORDER), | |
162 | desc!(video; "realvideo4", "Real Video 4", CODEC_CAP_REORDER), | |
163 | desc!(video; "realvideo6", "Real Video 6", CODEC_CAP_REORDER), | |
164 | desc!(video; "clearvideo", "ClearVideo"), | |
165 | desc!(video; "clearvideo_rm", "ClearVideo"), | |
166 | desc!(audio; "ra14.4", "RealAudio 14.4"), | |
167 | desc!(audio; "ra28.8", "RealAudio 28.8"), | |
168 | desc!(audio; "cook", "RealAudio Cooker"), | |
169 | desc!(audio; "ralf", "RealAudio Lossless"), | |
170 | desc!(audio; "aac", "AAC"), | |
171 | desc!(audio; "ac3", "ETSI TS 102 366"), | |
172 | desc!(audio; "atrac3", "Sony Atrac3"), | |
173 | desc!(audio; "sipro", "Sipro Labs ADPCM"), | |
174 | ||
175 | desc!(video; "truemotion1", "TrueMotion 1"), | |
176 | desc!(video-im; "truemotionrt", "TrueMotion RT"), | |
177 | desc!(video; "truemotion2", "TrueMotion 2"), | |
178 | desc!(video; "truemotion2x", "TrueMotion 2X"), | |
179 | desc!(video; "vp3", "VP3"), | |
180 | desc!(video; "vp4", "VP4"), | |
181 | desc!(video; "vp5", "VP5"), | |
182 | desc!(video; "vp6", "VP6"), | |
183 | desc!(video; "vp6a", "VP6"), | |
184 | desc!(video; "vp7", "VP7"), | |
185 | desc!(video; "vp8", "VP8"), | |
186 | desc!(video; "vp9", "VP9"), | |
187 | desc!(audio; "adpcm-dk3", "Duck DK3 ADPCM"), | |
188 | desc!(audio; "adpcm-dk4", "Duck DK4 ADPCM"), | |
189 | desc!(audio; "on2avc-500", "On2 AVC"), | |
190 | desc!(audio; "on2avc-501", "On2 AVC"), | |
191 | ||
192 | desc!(video; "gdv-video", "Gremlin Digital Video - video"), | |
193 | desc!(audio; "gdv-audio", "Gremlin Digital Video - audio"), | |
194 | desc!(video; "bmv-video", "BMV video"), | |
195 | desc!(audio; "bmv-audio", "BMV audio"), | |
196 | desc!(video; "bmv3-video", "DW Noir BMV video"), | |
197 | desc!(audio; "bmv3-audio", "DW Noir BMV audio"), | |
198 | desc!(video; "midivid", "MidiVid"), | |
199 | desc!(video; "midivid3", "MidiVid 3"), | |
200 | desc!(video-ll; "midivid-ll", "MidiVid Lossless"), | |
201 | desc!(video; "vmd-video", "VMD video"), | |
202 | desc!(audio; "vmd-audio", "VMD audio"), | |
203 | ||
204 | desc!(video; "smacker-video", "Smacker video"), | |
205 | desc!(audio; "smacker-audio", "Smacker audio"), | |
206 | desc!(video; "bink-video", "Bink video"), | |
207 | desc!(video; "bink2-video", "Bink2 video"), | |
208 | desc!(audio; "bink-audio-dct", "Bink audio (DCT)"), | |
209 | desc!(audio; "bink-audio-rdft", "Bink audio (RDFT)"), | |
210 | ]; | |
211 | ||
212 | static AVI_VIDEO_CODEC_REGISTER: &'static [(&[u8;4], &str)] = &[ | |
213 | (b"IF09", "indeo1"), | |
214 | (b"RT21", "indeo2"), | |
215 | (b"IV31", "indeo3"), | |
216 | (b"IV32", "indeo3"), | |
217 | (b"IV41", "indeo4"), | |
218 | (b"IV50", "indeo5"), | |
219 | (b"I263", "intel263"), | |
220 | ||
221 | (b"UCOD", "clearvideo"), | |
222 | ||
223 | (b"MVDV", "midivid"), | |
224 | (b"MV30", "midivid3"), | |
225 | (b"MVLZ", "midivid-ll"), | |
226 | ||
227 | (b"DUCK", "truemotion1"), | |
228 | (b"TR20", "truemotionrt"), | |
229 | (b"TM20", "truemotion2"), | |
230 | (b"TM2A", "truemotion2x"), | |
231 | (b"TM2X", "truemotion2x"), | |
232 | (b"VP30", "vp3"), | |
233 | (b"VP31", "vp3"), | |
234 | (b"VP40", "vp4"), | |
235 | (b"VP50", "vp5"), | |
236 | (b"VP60", "vp6"), | |
237 | (b"VP61", "vp6"), | |
238 | (b"VP62", "vp6"), | |
239 | (b"VP6A", "vp6a"), | |
240 | (b"VP70", "vp7"), | |
241 | ]; | |
242 | ||
243 | static WAV_CODEC_REGISTER: &'static [(u16, &str)] = &[ | |
244 | (0x0000, "pcm"), | |
245 | (0x0001, "pcm"), | |
246 | (0x0003, "pcm"), | |
247 | (0x0061, "adpcm-dk4"), | |
248 | (0x0062, "adpcm-dk3"), | |
249 | (0x0401, "imc"), | |
250 | (0x0402, "iac"), | |
251 | (0x0500, "on2avc-500"), | |
252 | (0x0501, "on2avc-501"), | |
253 | ]; | |
254 | ||
255 | /// Returns video codec short name for provided FOURCC (used in AVI format). | |
256 | pub fn find_codec_from_avi_fourcc(fcc: &[u8;4]) -> Option<&'static str> { | |
257 | for (fourcc, name) in AVI_VIDEO_CODEC_REGISTER.iter() { | |
258 | if *fourcc == fcc { return Some(name); } | |
259 | } | |
260 | None | |
261 | } | |
262 | ||
263 | /// Returns known audio codec short name for provided TWOCC (used in WAV and AVI format). | |
264 | pub fn find_codec_from_wav_twocc(tcc: u16) -> Option<&'static str> { | |
265 | for (twocc, name) in WAV_CODEC_REGISTER.iter() { | |
266 | if *twocc == tcc { return Some(name); } | |
267 | } | |
268 | None | |
269 | } | |
270 | ||
271 | #[cfg(test)] | |
272 | mod test { | |
273 | use super::*; | |
274 | ||
275 | #[test] | |
276 | fn test_register() { | |
277 | let c1 = find_codec_from_avi_fourcc(b"IV41").unwrap(); | |
278 | let c2 = find_codec_from_wav_twocc(0x401).unwrap(); | |
279 | println!("found {} and {}", c1, c2); | |
280 | let cd1 = get_codec_description(c1).unwrap(); | |
281 | let cd2 = get_codec_description(c2).unwrap(); | |
282 | println!("got {} and {}", cd1, cd2); | |
283 | } | |
284 | } |