1 //! Global registry of codec information.
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.
7 #[derive(Debug,Clone,Copy,PartialEq)]
16 /// Some special codec (e.g. some event stream or separate timecodes stream).
22 impl fmt::Display for CodecType {
23 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
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, "-"),
34 /// Codec capability flag for intra-only codecs.
35 pub const CODEC_CAP_INTRAONLY:u32 = 0x0001;
36 /// Codec capability flag for lossless codecs.
37 pub const CODEC_CAP_LOSSLESS:u32 = 0x0002;
38 /// Codec capability flag for codecs with frame reordering.
39 pub const CODEC_CAP_REORDER:u32 = 0x0004;
40 /// Codec capability flag for codecs that can be both lossy and lossless.
41 pub const CODEC_CAP_HYBRID:u32 = 0x0008;
42 /// Codec capability flag for codecs with scalability features.
43 pub const CODEC_CAP_SCALABLE:u32 = 0x0010;
44 /// Codec capability flag for codecs with complex frame reordering.
45 pub const CODEC_CAP_COMPLEX_REORDER:u32 = 0x0020;
47 /// Codec description structure.
49 pub struct CodecDescription {
52 /// Short codec name is used inside NihAV as the unique identifier.
53 pub name: &'static str,
55 pub fname: &'static str,
58 /// Codec capabilities.
62 impl CodecDescription {
63 /// Returns short codec name.
64 pub fn get_name(&self) -> &'static str { self.name }
65 /// Returns full codec name.
66 pub fn get_full_name(&self) -> &'static str { self.fname }
67 /// Returns codec type.
68 pub fn get_codec_type(&self) -> CodecType { self.ctype }
69 /// Reports whether the codec has only intra frames or not.
70 pub fn is_intraonly(&self) -> bool { (self.caps & CODEC_CAP_INTRAONLY) != 0 }
71 /// Reports whether the codec is lossless.
72 pub fn is_lossless(&self) -> bool { (self.caps & CODEC_CAP_LOSSLESS) != 0 }
73 /// Reports whether the codec requires frame reordering.
74 pub fn has_reorder(&self) -> bool { (self.caps & CODEC_CAP_REORDER) != 0 }
75 /// Reports whether the codec can be either lossless or lossy.
76 pub fn is_hybrid(&self) -> bool { (self.caps & CODEC_CAP_HYBRID) != 0 }
77 /// Reports whether codec supports scalability.
79 /// Scalability means that codec can be decoded in reduced resolution by design.
80 pub fn is_scalable(&self) -> bool { (self.caps & CODEC_CAP_SCALABLE) != 0 }
83 impl fmt::Display for CodecDescription {
84 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
85 let mut out = self.fname.to_string();
87 let mut capfmt = "".to_string();
88 if (self.caps & CODEC_CAP_INTRAONLY) != 0 {
89 capfmt = format!("{} Intra-only", capfmt);
91 if (self.caps & CODEC_CAP_LOSSLESS) != 0 {
92 capfmt = format!("{} Lossless", capfmt);
94 if (self.caps & CODEC_CAP_REORDER) != 0 {
95 capfmt = format!("{} Frame reorder", capfmt);
97 if (self.caps & CODEC_CAP_HYBRID) != 0 {
98 capfmt = format!("{} Can be lossy and lossless", capfmt);
100 if (self.caps & CODEC_CAP_SCALABLE) != 0 {
101 capfmt = format!("{} Scalable", capfmt);
103 out = format!("{} ({})", out, capfmt);
110 (video; $n:expr, $fn:expr) => ({
111 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
114 (video; $n:expr, $fn:expr, $c:expr) => ({
115 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
118 (video-ll; $n:expr, $fn:expr) => ({
119 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
120 caps: CODEC_CAP_LOSSLESS | CODEC_CAP_INTRAONLY }
122 (video-llp; $n:expr, $fn:expr) => ({
123 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
124 caps: CODEC_CAP_LOSSLESS }
126 (video-im; $n:expr, $fn:expr) => ({
127 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
128 caps: CODEC_CAP_INTRAONLY }
130 (video-modern; $n:expr, $fn:expr) => ({
131 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Video,
132 caps: CODEC_CAP_REORDER | CODEC_CAP_HYBRID }
134 (audio; $n:expr, $fn:expr) => ({
135 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Audio,
138 (audio-ll; $n:expr, $fn:expr) => ({
139 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Audio,
140 caps: CODEC_CAP_LOSSLESS | CODEC_CAP_INTRAONLY }
142 (audio-hyb; $n:expr, $fn:expr) => ({
143 CodecDescription{ name: $n, fname: $fn, ctype: CodecType::Audio,
144 caps: CODEC_CAP_HYBRID }
148 /// Returns codec description for the provided codec short name if it is found.
149 pub fn get_codec_description(name: &str) -> Option<&'static CodecDescription> {
150 CODEC_REGISTER.iter().find(|®| reg.name == name)
153 static CODEC_REGISTER: &[CodecDescription] = &[
154 desc!(audio-ll; "pcm", "PCM"),
155 desc!(audio; "alaw", "A-law PCM"),
156 desc!(audio; "ulaw", "mu-law PCM"),
158 desc!(video-im; "indeo1", "Intel Raw IF09"),
159 desc!(video; "indeo2", "Intel Indeo 2"),
160 desc!(video; "ima-rtv2", "Intel RTV 2 (Indeo 2)"),
161 desc!(video; "indeo3", "Intel Indeo 3"),
162 desc!(video; "indeo4", "Intel Indeo 4", CODEC_CAP_REORDER | CODEC_CAP_SCALABLE),
163 desc!(video; "indeo5", "Intel Indeo 5", CODEC_CAP_REORDER | CODEC_CAP_SCALABLE),
164 desc!(video; "indeo5s", "Intel Indeo 5 Scalable", CODEC_CAP_SCALABLE),
165 desc!(video; "intel263", "Intel I263", CODEC_CAP_REORDER),
166 desc!(video-im; "yv92", "Intel Indeo YVU9 Compressed"),
167 desc!(audio; "iac", "Intel Indeo audio"),
168 desc!(audio; "imc", "Intel Music Coder"),
169 desc!(audio; "dvi-adpcm", "Intel DVI ADPCM"),
171 desc!(video; "realvideo1", "Real Video 1"),
172 desc!(video; "realvideo2", "Real Video 2", CODEC_CAP_REORDER),
173 desc!(video; "realvideo3", "Real Video 3", CODEC_CAP_REORDER),
174 desc!(video; "realvideo4", "Real Video 4", CODEC_CAP_REORDER),
175 desc!(video; "realvideo6", "Real Video 6", CODEC_CAP_REORDER),
176 desc!(video; "clearvideo", "ClearVideo"),
177 desc!(video; "clearvideo_rm", "ClearVideo"),
178 desc!(audio; "ra14.4", "RealAudio 14.4"),
179 desc!(audio; "ra28.8", "RealAudio 28.8"),
180 desc!(audio; "cook", "RealAudio Cooker"),
181 desc!(audio; "ralf", "RealAudio Lossless"),
182 desc!(audio; "aac", "AAC"),
183 desc!(audio; "ac3", "ETSI TS 102 366"),
184 desc!(audio; "ac3-multi", "ETSI TS 102 366 (multiple frames)"),
185 desc!(audio; "atrac3", "Sony Atrac3"),
186 desc!(audio; "sipro", "Sipro Labs ADPCM"),
189 desc!(video-ll; "rawvideo", "Raw video data"),
190 desc!(video-ll; "rawvideo-ms", "Raw video data"),
192 desc!(video; "cinepak", "Cinepak"),
194 desc!(video-llp; "zmbv", "Zip Motion Blocks Video"),
196 desc!(video; "msvideo1", "MS Video 1"),
197 desc!(video; "msrle", "MS RLE"),
198 desc!(audio; "ms-adpcm", "MS ADPCM"),
199 desc!(audio; "ima-adpcm-ms", "IMA ADPCM (MS variant)"),
201 desc!(video; "qt-smc", "Apple Graphics"),
202 desc!(video; "qt-rle", "Apple Animation"),
203 desc!(video; "apple-video", "Apple video"),
204 desc!(video; "qdraw", "Apple QuickDraw"),
205 desc!(video; "sorenson-video", "Sorenson Video"),
206 desc!(video; "sorenson-video3", "Sorenson Video 3", CODEC_CAP_REORDER),
207 desc!(video-ll; "qt-yuv2", "Raw YUV"),
208 desc!(video-ll; "qt-yuv4", "libquicktime YUV4"),
209 desc!(audio-ll; "alac", "Apple Lossless Audio Codec"),
210 desc!(audio; "mace-3", "MACE 3:1"),
211 desc!(audio; "mace-6", "MACE 6:1"),
212 desc!(audio; "ima-adpcm-qt", "IMA ADPCM (Apple variant)"),
213 desc!(audio; "qdesign-music", "QDesign Music"),
214 desc!(audio; "qdesign-music2", "QDesign Music v2"),
215 desc!(audio; "qualcomm-purevoice", "Qualcomm PureVoice"),
217 desc!(video-ll; "arm_rawvideo", "Acorn Replay Movie raw video formats"),
218 desc!(audio; "arm_rawaudio", "Acorn Replay Movie raw audio formats"),
219 desc!(video; "movinglines", "Acorn Moving Lines"),
220 desc!(video; "movingblocks", "Acorn Moving Blocks"),
221 desc!(video; "movingblockshq", "Acorn Moving Blocks HQ"),
222 desc!(video; "supermovingblocks", "Acorn Super Moving Blocks"),
223 desc!(video; "linepack", "Henrik Pedersen's LinePack"),
224 desc!(video; "movie16_3", "Henrik Pedersen's Movie 16:3"),
225 desc!(video; "escape-any", "wrapper for Eidos Escape codecs"),
226 desc!(video; "escape100", "Eidos Escape 100"),
227 desc!(video; "escape102", "Eidos Escape 102"),
228 desc!(video; "escape122", "Eidos Escape 122"),
229 desc!(video; "escape124", "Eidos Escape 124"),
230 desc!(video; "escape130", "Eidos Escape 130"),
231 desc!(audio; "escape-adpcm", "Eidos Escape ADPCM"),
232 desc!(video-llp; "euclid", "Iota Euclid / The Complete Animation"),
233 desc!(audio; "iota-sound", "IotaSound"),
235 desc!(video; "truemotion1", "TrueMotion 1"),
236 desc!(video-im; "truemotionrt", "TrueMotion RT"),
237 desc!(video; "truemotion2", "TrueMotion 2"),
238 desc!(video; "truemotion2x", "TrueMotion 2X"),
239 desc!(video; "vp3", "VP3"),
240 desc!(video; "vp4", "VP4"),
241 desc!(video; "vp5", "VP5"),
242 desc!(video; "vp6", "VP6"),
243 desc!(video; "vp6f", "VP6 (in Flash)"),
244 desc!(video; "vp6a", "VP6 with alpha"),
245 desc!(video; "vp7", "VP7"),
246 desc!(video; "vp8", "VP8"),
247 desc!(video; "vp9", "VP9"),
248 desc!(audio; "adpcm-dk3", "Duck DK3 ADPCM"),
249 desc!(audio; "adpcm-dk4", "Duck DK4 ADPCM"),
250 desc!(audio; "on2avc-500", "On2 AVC"),
251 desc!(audio; "on2avc-501", "On2 AVC"),
253 desc!(video; "flv263", "Sorenson H.263"),
254 desc!(video-llp; "flashsv", "Flash Screen Video"),
255 desc!(video-llp; "flashsv2", "Flash Screen Video 2"),
256 desc!(audio; "asao", "N*llym*s*r ASAO"),
257 desc!(audio; "flv-adpcm", "Flash ADPCM"),
259 desc!(audio; "mp1", "MPEG Audio Layer I"),
260 desc!(audio; "mp2", "MPEG Audio Layer II"),
261 desc!(audio; "mp3", "MPEG Audio Layer III"),
262 desc!(audio; "mp3-multi", "MPEG Audio Layer III (multiple frames)"),
263 desc!(audio; "speex", "Speex"),
265 desc!(video; "gdv-video", "Gremlin Digital Video - video"),
266 desc!(audio; "gdv-audio", "Gremlin Digital Video - audio"),
267 desc!(video-im; "arxel-video", "Arxel Tribe Video"),
268 desc!(video; "beam-fcp", "Beam Software Animation"),
269 desc!(video; "beam-video", "Beam Software Video"),
270 desc!(video; "bmv-video", "BMV video"),
271 desc!(audio; "bmv-audio", "BMV audio"),
272 desc!(video; "bmv3-video", "DW Noir BMV video"),
273 desc!(audio; "bmv3-audio", "DW Noir BMV audio"),
274 desc!(video; "dp-sga", "Digital Pictures SGA video"),
275 desc!(video; "fable-imax", "Fable IMAX video"),
276 desc!(video; "fst-video", "FutureVision video"),
277 desc!(audio; "fst-audio", "FutureVision audio"),
278 desc!(video; "hl-fmv-video", "Highlander FMV video"),
279 desc!(video-llp; "ipma", "Imagination Pilots Matte Animation"),
280 desc!(video-llp; "ipma2", "Imagination Pilots Matte Animation v2"),
281 desc!(video; "kmvc", "Karl Morton's Video Codec"),
282 desc!(video; "legend-q-video", "Legend Entertainment Q video"),
283 desc!(video; "midivid", "MidiVid"),
284 desc!(video; "midivid3", "MidiVid 3"),
285 desc!(video-ll; "midivid-ll", "MidiVid Lossless"),
286 desc!(video-llp; "pdq2", "PDQ2"),
287 desc!(video-ll; "rbt-video", "Sierra Robot video"),
288 desc!(audio; "rbt-audio", "Sierra Robot audio"),
289 desc!(video; "seq-video", "Sierra Sequence video"),
290 desc!(video; "smushv1", "SMUSH Video paletted"),
291 desc!(video; "smushv2", "SMUSH Video 16-bit"),
292 desc!(video; "smush-iact", "SMUSH IACT Audio"),
293 desc!(video; "smush-vima", "SMUSH VIMA Audio"),
294 desc!(video; "vmd-video", "VMD video"),
295 desc!(audio; "vmd-audio", "VMD audio"),
296 desc!(video; "vxvideo", "Actimagine Vx"),
297 desc!(audio; "vxaudio", "Actimagine Sx"),
299 desc!(video; "smacker-video", "Smacker video"),
300 desc!(audio; "smacker-audio", "Smacker audio"),
301 desc!(video; "bink-video", "Bink video"),
302 desc!(video; "bink2-video", "Bink2 video"),
303 desc!(audio; "bink-audio-dct", "Bink audio (DCT)"),
304 desc!(audio; "bink-audio-rdft", "Bink audio (RDFT)"),
306 desc!(audio; "lhst15f8", "L&H StreamTalk 15kbps at 8 kHz"),
307 desc!(audio; "lhst250f11", "L&H StreamTalk 25kbps at 11 kHz"),
308 desc!(audio; "lhst500f22", "L&H StreamTalk 50kpbs at 22 kHz"),
309 desc!(audio; "lhst48", "L&H StreamTalk CELP Codec 4.8kbps at 8 kHz"),
311 desc!(video; "vivo1", "VivoActive Video 1.0"),
312 desc!(video; "vivo2", "VivoActive Video 2.0", CODEC_CAP_REORDER),
313 desc!(audio; "g723.1", "ITU G.723.1"),
314 desc!(audio; "siren", "Polycom Siren"),
316 desc!(audio-ll; "ape", "Monkey's Audio"),
317 desc!(audio-ll; "flac", "Free Lossless Audio Codec"),
318 desc!(audio-ll; "tta", "True Audio codec"),
319 desc!(audio-hyb; "wavpack", "WavPack"),
321 desc!(video-ll; "gif", "GIF"),
322 desc!(video-im; "jpeg", "JPEG"),
323 desc!(video; "h264", "ITU H.264", CODEC_CAP_COMPLEX_REORDER | CODEC_CAP_HYBRID),
324 desc!(video-modern; "mpeg4asp", "MPEG-4 ASP"),
326 desc!(video; "fif", "Fractal Codec"),
328 desc!(video-im; "mvi0", "MotionPixels (MVI)"),
329 desc!(video; "mvi1", "MotionPixels 1"),
330 desc!(video; "mvi2", "MotionPixels 2"),
332 desc!(video; "gryphon-arbc-vfw", "Gryphon Software ARBC in AVI"),
333 desc!(video; "gryphon-arbc-qt", "Gryphon Software ARBC in MOV"),
335 desc!(video-im; "mwv1", "Aware MotionWavelets"),
337 desc!(video-llp; "pivideo", "PI-Video"),
339 desc!(video-im; "pgvv", "Radius Studio Video"),
341 desc!(video-llp; "qpeg-dvc", "QPEG video in DVC"),
343 desc!(video; "teal-video", "TealMovie video"),
344 desc!(audio; "teal-audio", "TealMovie audio"),
346 desc!(video; "ultimotion", "IBM Ultimotion"),
349 static AVI_VIDEO_CODEC_REGISTER: &[(&[u8;4], &str)] = &[
350 (&[1, 0, 0, 0], "msrle"),
351 (&[2, 0, 0, 0], "msrle"),
353 (b"CRAM", "msvideo1"),
354 (b"MSVC", "msvideo1"),
355 (b"WHAM", "msvideo1"),
365 (b"I263", "intel263"),
368 (b"UCOD", "clearvideo"),
369 (b"cvid", "cinepak"),
370 (b"savi", "cinepak"),
371 (b"tony", "cinepak"),
378 (b"MVDV", "midivid"),
379 (b"MV30", "midivid3"),
380 (b"MVLZ", "midivid-ll"),
384 (b"tmot", "truemotion1"),
385 (b"DUCK", "truemotion1"),
386 (b"TR20", "truemotionrt"),
387 (b"TM20", "truemotion2"),
388 (b"TM2A", "truemotion2x"),
389 (b"TM2X", "truemotion2x"),
406 (b"pivc", "pivideo"),
408 (b"ULTI", "ultimotion"),
410 (b"ARBC", "gryphon-arbc-vfw"),
411 (b"azpr", "apple-video"),
414 (b"ESCP", "escape-any"),
416 (b"VXS1", "vxvideo"),
418 (b"DX50", "mpeg4asp"),
419 (b"DIVX", "mpeg4asp"),
420 (b"XVID", "mpeg4asp"),
423 static WAV_CODEC_REGISTER: &[(u16, &str)] = &[
426 (0x0002, "ms-adpcm"),
430 (0x0011, "ima-adpcm-ms"),
431 (0x0055, "mp3-multi"),
432 (0x0061, "adpcm-dk4"),
433 (0x0062, "adpcm-dk3"),
436 (0x0500, "on2avc-500"),
437 (0x0501, "on2avc-501"),
438 (0x2000, "ac3-multi"),
441 static MOV_VIDEO_CODEC_REGISTER: &[(&[u8;4], &str)] = &[
442 (b"cvid", "cinepak"),
444 (b"raw ", "rawvideo"),
448 (b"rpza", "apple-video"),
450 (b"kpcd", "kodak-photocd"),
451 //(b"mpeg", "mpeg-video"),
452 (b"mjpa", "mjpeg-a"),
453 (b"mjpb", "mjpeg-b"),
454 (b"svqi", "sorenson-video"),
455 (b"SVQ1", "sorenson-video"),
456 (b"svq3", "sorenson-video3"),
457 (b"SVQ3", "sorenson-video3"),
464 (b"arbc", "gryphon-arbc-qt"),
465 (b"UCOD", "clearvideo"),
470 (b"ESCP", "escape-any"),
472 (b"mp4v", "mpeg4asp"),
475 (b"j420", "rawvideo"),
476 (b"yuv2", "qt-yuv2"),
477 (b"yuv4", "qt-yuv4"),
480 static MOV_AUDIO_CODEC_REGISTER: &[(&[u8;4], &str)] = &[
491 (b"ima4", "ima-adpcm-qt"),
494 (b"dvca", "dv-audio"),
495 (b"QDMC", "qdesign-music"),
496 (b"QDM2", "qdesign-music2"),
497 (b"Qclp", "qualcomm-purevoice"),
498 //(b".mp3", "mpeg-layer3"),
505 /// Returns video codec short name for provided FOURCC (used in AVI format).
506 pub fn find_codec_from_avi_fourcc(fcc: &[u8;4]) -> Option<&'static str> {
507 for (fourcc, name) in AVI_VIDEO_CODEC_REGISTER.iter() {
508 if *fourcc == fcc { return Some(name); }
513 /// Returns FOURCC (used in AVI format) for provided codec name.
514 pub fn find_avi_fourcc(codecname: &str) -> Option<[u8; 4]> {
515 for (fourcc, name) in AVI_VIDEO_CODEC_REGISTER.iter() {
516 if *name == codecname { return Some(**fourcc); }
521 /// Returns known audio codec short name for provided TWOCC (used in WAV and AVI format).
522 pub fn find_codec_from_wav_twocc(tcc: u16) -> Option<&'static str> {
523 for (twocc, name) in WAV_CODEC_REGISTER.iter() {
524 if *twocc == tcc { return Some(name); }
529 /// Returns TWOCC (used in WAV and AVI format for provided codec name.
530 pub fn find_wav_twocc(codecname: &str) -> Option<u16> {
531 for (twocc, name) in WAV_CODEC_REGISTER.iter() {
532 if *name == codecname { return Some(*twocc); }
537 /// Returns video codec short name for provided FOURCC (used in MOV format).
538 pub fn find_codec_from_mov_video_fourcc(fcc: &[u8;4]) -> Option<&'static str> {
539 for (fourcc, name) in MOV_VIDEO_CODEC_REGISTER.iter() {
540 if *fourcc == fcc { return Some(name); }
545 /// Returns known audio codec short name for provided FOURCC (used in MOV format).
546 pub fn find_codec_from_mov_audio_fourcc(fcc: &[u8;4]) -> Option<&'static str> {
547 for (fourcc, name) in MOV_AUDIO_CODEC_REGISTER.iter() {
548 if *fourcc == fcc { return Some(name); }
559 let c1 = find_codec_from_avi_fourcc(b"IV41").unwrap();
560 let c2 = find_codec_from_wav_twocc(0x401).unwrap();
561 println!("found {} and {}", c1, c2);
562 let cd1 = get_codec_description(c1).unwrap();
563 let cd2 = get_codec_description(c2).unwrap();
564 println!("got {} and {}", cd1, cd2);