2 /////////////////////////////////////////////////////////////////
3 /// getID3() by James Heinrich <info@getid3.org> //
4 // available at http://getid3.sourceforge.net //
5 // or http://www.getid3.org //
6 // also https://github.com/JamesHeinrich/getID3 //
7 /////////////////////////////////////////////////////////////////
8 // See readme.txt for more details //
9 /////////////////////////////////////////////////////////////////
11 // module.audio.dts.php //
12 // module for analyzing DTS Audio files //
13 // dependencies: NONE //
15 /////////////////////////////////////////////////////////////////
19 * @tutorial http://wiki.multimedia.cx/index.php?title=DTS
21 class getid3_dts extends getid3_handler
24 * Default DTS syncword used in native .cpt or .dts formats
26 const syncword = "\x7F\xFE\x80\x01";
28 private $readBinDataOffset = 0;
31 * Possible syncwords indicating bitstream encoding
33 public static $syncwords = array(
34 0 => "\x7F\xFE\x80\x01", // raw big-endian
35 1 => "\xFE\x7F\x01\x80", // raw little-endian
36 2 => "\x1F\xFF\xE8\x00", // 14-bit big-endian
37 3 => "\xFF\x1F\x00\xE8"); // 14-bit little-endian
39 public function Analyze() {
40 $info = &$this->getid3->info;
41 $info['fileformat'] = 'dts';
43 $this->fseek($info['avdataoffset']);
44 $DTSheader = $this->fread(20); // we only need 2 words magic + 6 words frame header, but these words may be normal 16-bit words OR 14-bit words with 2 highest bits set to zero, so 8 words can be either 8*16/8 = 16 bytes OR 8*16*(16/14)/8 = 18.3 bytes
47 $sync = substr($DTSheader, 0, 4);
48 if (($encoding = array_search($sync, self::$syncwords)) !== false) {
50 $info['dts']['raw']['magic'] = $sync;
51 $this->readBinDataOffset = 32;
53 } elseif ($this->isDependencyFor('matroska')) {
55 // Matroska contains DTS without syncword encoded as raw big-endian format
57 $this->readBinDataOffset = 0;
61 unset($info['fileformat']);
62 return $this->error('Expecting "'.implode('| ', array_map('getid3_lib::PrintHexBytes', self::$syncwords)).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes($sync).'"');
68 for ($word_offset = 0; $word_offset <= strlen($DTSheader); $word_offset += 2) {
70 case 0: // raw big-endian
71 $fhBS .= getid3_lib::BigEndian2Bin( substr($DTSheader, $word_offset, 2) );
73 case 1: // raw little-endian
74 $fhBS .= getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2)));
76 case 2: // 14-bit big-endian
77 $fhBS .= substr(getid3_lib::BigEndian2Bin( substr($DTSheader, $word_offset, 2) ), 2, 14);
79 case 3: // 14-bit little-endian
80 $fhBS .= substr(getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2))), 2, 14);
85 $info['dts']['raw']['frame_type'] = $this->readBinData($fhBS, 1);
86 $info['dts']['raw']['deficit_samples'] = $this->readBinData($fhBS, 5);
87 $info['dts']['flags']['crc_present'] = (bool) $this->readBinData($fhBS, 1);
88 $info['dts']['raw']['pcm_sample_blocks'] = $this->readBinData($fhBS, 7);
89 $info['dts']['raw']['frame_byte_size'] = $this->readBinData($fhBS, 14);
90 $info['dts']['raw']['channel_arrangement'] = $this->readBinData($fhBS, 6);
91 $info['dts']['raw']['sample_frequency'] = $this->readBinData($fhBS, 4);
92 $info['dts']['raw']['bitrate'] = $this->readBinData($fhBS, 5);
93 $info['dts']['flags']['embedded_downmix'] = (bool) $this->readBinData($fhBS, 1);
94 $info['dts']['flags']['dynamicrange'] = (bool) $this->readBinData($fhBS, 1);
95 $info['dts']['flags']['timestamp'] = (bool) $this->readBinData($fhBS, 1);
96 $info['dts']['flags']['auxdata'] = (bool) $this->readBinData($fhBS, 1);
97 $info['dts']['flags']['hdcd'] = (bool) $this->readBinData($fhBS, 1);
98 $info['dts']['raw']['extension_audio'] = $this->readBinData($fhBS, 3);
99 $info['dts']['flags']['extended_coding'] = (bool) $this->readBinData($fhBS, 1);
100 $info['dts']['flags']['audio_sync_insertion'] = (bool) $this->readBinData($fhBS, 1);
101 $info['dts']['raw']['lfe_effects'] = $this->readBinData($fhBS, 2);
102 $info['dts']['flags']['predictor_history'] = (bool) $this->readBinData($fhBS, 1);
103 if ($info['dts']['flags']['crc_present']) {
104 $info['dts']['raw']['crc16'] = $this->readBinData($fhBS, 16);
106 $info['dts']['flags']['mri_perfect_reconst'] = (bool) $this->readBinData($fhBS, 1);
107 $info['dts']['raw']['encoder_soft_version'] = $this->readBinData($fhBS, 4);
108 $info['dts']['raw']['copy_history'] = $this->readBinData($fhBS, 2);
109 $info['dts']['raw']['bits_per_sample'] = $this->readBinData($fhBS, 2);
110 $info['dts']['flags']['surround_es'] = (bool) $this->readBinData($fhBS, 1);
111 $info['dts']['flags']['front_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
112 $info['dts']['flags']['surround_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
113 $info['dts']['raw']['dialog_normalization'] = $this->readBinData($fhBS, 4);
116 $info['dts']['bitrate'] = self::bitrateLookup($info['dts']['raw']['bitrate']);
117 $info['dts']['bits_per_sample'] = self::bitPerSampleLookup($info['dts']['raw']['bits_per_sample']);
118 $info['dts']['sample_rate'] = self::sampleRateLookup($info['dts']['raw']['sample_frequency']);
119 $info['dts']['dialog_normalization'] = self::dialogNormalization($info['dts']['raw']['dialog_normalization'], $info['dts']['raw']['encoder_soft_version']);
120 $info['dts']['flags']['lossless'] = (($info['dts']['raw']['bitrate'] == 31) ? true : false);
121 $info['dts']['bitrate_mode'] = (($info['dts']['raw']['bitrate'] == 30) ? 'vbr' : 'cbr');
122 $info['dts']['channels'] = self::numChannelsLookup($info['dts']['raw']['channel_arrangement']);
123 $info['dts']['channel_arrangement'] = self::channelArrangementLookup($info['dts']['raw']['channel_arrangement']);
125 $info['audio']['dataformat'] = 'dts';
126 $info['audio']['lossless'] = $info['dts']['flags']['lossless'];
127 $info['audio']['bitrate_mode'] = $info['dts']['bitrate_mode'];
128 $info['audio']['bits_per_sample'] = $info['dts']['bits_per_sample'];
129 $info['audio']['sample_rate'] = $info['dts']['sample_rate'];
130 $info['audio']['channels'] = $info['dts']['channels'];
131 $info['audio']['bitrate'] = $info['dts']['bitrate'];
132 if (isset($info['avdataend']) && !empty($info['dts']['bitrate']) && is_numeric($info['dts']['bitrate'])) {
133 $info['playtime_seconds'] = ($info['avdataend'] - $info['avdataoffset']) / ($info['dts']['bitrate'] / 8);
134 if (($encoding == 2) || ($encoding == 3)) {
135 // 14-bit data packed into 16-bit words, so the playtime is wrong because only (14/16) of the bytes in the data portion of the file are used at the specified bitrate
136 $info['playtime_seconds'] *= (14 / 16);
142 private function readBinData($bin, $length) {
143 $data = substr($bin, $this->readBinDataOffset, $length);
144 $this->readBinDataOffset += $length;
146 return bindec($data);
149 public static function bitrateLookup($index) {
150 static $lookup = array(
184 return (isset($lookup[$index]) ? $lookup[$index] : false);
187 public static function sampleRateLookup($index) {
188 static $lookup = array(
206 return (isset($lookup[$index]) ? $lookup[$index] : false);
209 public static function bitPerSampleLookup($index) {
210 static $lookup = array(
216 return (isset($lookup[$index]) ? $lookup[$index] : false);
219 public static function numChannelsLookup($index) {
257 public static function channelArrangementLookup($index) {
258 static $lookup = array(
260 1 => 'A + B (dual mono)',
261 2 => 'L + R (stereo)',
262 3 => '(L+R) + (L-R) (sum-difference)',
263 4 => 'LT + RT (left and right total)',
266 7 => 'C + L + R + S',
267 8 => 'L + R + SL + SR',
268 9 => 'C + L + R + SL + SR',
269 10 => 'CL + CR + L + R + SL + SR',
270 11 => 'C + L + R+ LR + RR + OV',
271 12 => 'CF + CR + LF + RF + LR + RR',
272 13 => 'CL + C + CR + L + R + SL + SR',
273 14 => 'CL + CR + L + R + SL1 + SL2 + SR1 + SR2',
274 15 => 'CL + C+ CR + L + R + SL + S + SR',
276 return (isset($lookup[$index]) ? $lookup[$index] : 'user-defined');
279 public static function dialogNormalization($index, $version) {
285 return 0 - 16 - $index;