| 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 | } |