3 /////////////////////////////////////////////////////////////////
4 /// getID3() by James Heinrich <info@getid3.org> //
5 // available at https://github.com/JamesHeinrich/getID3 //
6 // or https://www.getid3.org //
7 // or http://getid3.sourceforge.net //
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";
31 private $readBinDataOffset = 0;
34 * Possible syncwords indicating bitstream encoding.
36 public static $syncwords = array(
37 0 => "\x7F\xFE\x80\x01", // raw big-endian
38 1 => "\xFE\x7F\x01\x80", // raw little-endian
39 2 => "\x1F\xFF\xE8\x00", // 14-bit big-endian
40 3 => "\xFF\x1F\x00\xE8"); // 14-bit little-endian
45 public function Analyze() {
46 $info = &$this->getid3
->info
;
47 $info['fileformat'] = 'dts';
49 $this->fseek($info['avdataoffset']);
50 $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
53 $sync = substr($DTSheader, 0, 4);
54 if (($encoding = array_search($sync, self
::$syncwords)) !== false) {
56 $info['dts']['raw']['magic'] = $sync;
57 $this->readBinDataOffset
= 32;
59 } elseif ($this->isDependencyFor('matroska')) {
61 // Matroska contains DTS without syncword encoded as raw big-endian format
63 $this->readBinDataOffset
= 0;
67 unset($info['fileformat']);
68 return $this->error('Expecting "'.implode('| ', array_map('getid3_lib::PrintHexBytes', self
::$syncwords)).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib
::PrintHexBytes($sync).'"');
74 for ($word_offset = 0; $word_offset <= strlen($DTSheader); $word_offset +
= 2) {
76 case 0: // raw big-endian
77 $fhBS .= getid3_lib
::BigEndian2Bin( substr($DTSheader, $word_offset, 2) );
79 case 1: // raw little-endian
80 $fhBS .= getid3_lib
::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2)));
82 case 2: // 14-bit big-endian
83 $fhBS .= substr(getid3_lib
::BigEndian2Bin( substr($DTSheader, $word_offset, 2) ), 2, 14);
85 case 3: // 14-bit little-endian
86 $fhBS .= substr(getid3_lib
::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2))), 2, 14);
91 $info['dts']['raw']['frame_type'] = $this->readBinData($fhBS, 1);
92 $info['dts']['raw']['deficit_samples'] = $this->readBinData($fhBS, 5);
93 $info['dts']['flags']['crc_present'] = (bool) $this->readBinData($fhBS, 1);
94 $info['dts']['raw']['pcm_sample_blocks'] = $this->readBinData($fhBS, 7);
95 $info['dts']['raw']['frame_byte_size'] = $this->readBinData($fhBS, 14);
96 $info['dts']['raw']['channel_arrangement'] = $this->readBinData($fhBS, 6);
97 $info['dts']['raw']['sample_frequency'] = $this->readBinData($fhBS, 4);
98 $info['dts']['raw']['bitrate'] = $this->readBinData($fhBS, 5);
99 $info['dts']['flags']['embedded_downmix'] = (bool) $this->readBinData($fhBS, 1);
100 $info['dts']['flags']['dynamicrange'] = (bool) $this->readBinData($fhBS, 1);
101 $info['dts']['flags']['timestamp'] = (bool) $this->readBinData($fhBS, 1);
102 $info['dts']['flags']['auxdata'] = (bool) $this->readBinData($fhBS, 1);
103 $info['dts']['flags']['hdcd'] = (bool) $this->readBinData($fhBS, 1);
104 $info['dts']['raw']['extension_audio'] = $this->readBinData($fhBS, 3);
105 $info['dts']['flags']['extended_coding'] = (bool) $this->readBinData($fhBS, 1);
106 $info['dts']['flags']['audio_sync_insertion'] = (bool) $this->readBinData($fhBS, 1);
107 $info['dts']['raw']['lfe_effects'] = $this->readBinData($fhBS, 2);
108 $info['dts']['flags']['predictor_history'] = (bool) $this->readBinData($fhBS, 1);
109 if ($info['dts']['flags']['crc_present']) {
110 $info['dts']['raw']['crc16'] = $this->readBinData($fhBS, 16);
112 $info['dts']['flags']['mri_perfect_reconst'] = (bool) $this->readBinData($fhBS, 1);
113 $info['dts']['raw']['encoder_soft_version'] = $this->readBinData($fhBS, 4);
114 $info['dts']['raw']['copy_history'] = $this->readBinData($fhBS, 2);
115 $info['dts']['raw']['bits_per_sample'] = $this->readBinData($fhBS, 2);
116 $info['dts']['flags']['surround_es'] = (bool) $this->readBinData($fhBS, 1);
117 $info['dts']['flags']['front_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
118 $info['dts']['flags']['surround_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
119 $info['dts']['raw']['dialog_normalization'] = $this->readBinData($fhBS, 4);
122 $info['dts']['bitrate'] = self
::bitrateLookup($info['dts']['raw']['bitrate']);
123 $info['dts']['bits_per_sample'] = self
::bitPerSampleLookup($info['dts']['raw']['bits_per_sample']);
124 $info['dts']['sample_rate'] = self
::sampleRateLookup($info['dts']['raw']['sample_frequency']);
125 $info['dts']['dialog_normalization'] = self
::dialogNormalization($info['dts']['raw']['dialog_normalization'], $info['dts']['raw']['encoder_soft_version']);
126 $info['dts']['flags']['lossless'] = (($info['dts']['raw']['bitrate'] == 31) ?
true : false);
127 $info['dts']['bitrate_mode'] = (($info['dts']['raw']['bitrate'] == 30) ?
'vbr' : 'cbr');
128 $info['dts']['channels'] = self
::numChannelsLookup($info['dts']['raw']['channel_arrangement']);
129 $info['dts']['channel_arrangement'] = self
::channelArrangementLookup($info['dts']['raw']['channel_arrangement']);
131 $info['audio']['dataformat'] = 'dts';
132 $info['audio']['lossless'] = $info['dts']['flags']['lossless'];
133 $info['audio']['bitrate_mode'] = $info['dts']['bitrate_mode'];
134 $info['audio']['bits_per_sample'] = $info['dts']['bits_per_sample'];
135 $info['audio']['sample_rate'] = $info['dts']['sample_rate'];
136 $info['audio']['channels'] = $info['dts']['channels'];
137 $info['audio']['bitrate'] = $info['dts']['bitrate'];
138 if (isset($info['avdataend']) && !empty($info['dts']['bitrate']) && is_numeric($info['dts']['bitrate'])) {
139 $info['playtime_seconds'] = ($info['avdataend'] - $info['avdataoffset']) / ($info['dts']['bitrate'] / 8);
140 if (($encoding == 2) ||
($encoding == 3)) {
141 // 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
142 $info['playtime_seconds'] *= (14 / 16);
154 private function readBinData($bin, $length) {
155 $data = substr($bin, $this->readBinDataOffset
, $length);
156 $this->readBinDataOffset +
= $length;
158 return bindec($data);
164 * @return int|string|false
166 public static function bitrateLookup($index) {
167 static $lookup = array(
201 return (isset($lookup[$index]) ?
$lookup[$index] : false);
207 * @return int|string|false
209 public static function sampleRateLookup($index) {
210 static $lookup = array(
228 return (isset($lookup[$index]) ?
$lookup[$index] : false);
236 public static function bitPerSampleLookup($index) {
237 static $lookup = array(
243 return (isset($lookup[$index]) ?
$lookup[$index] : false);
251 public static function numChannelsLookup($index) {
294 public static function channelArrangementLookup($index) {
295 static $lookup = array(
297 1 => 'A + B (dual mono)',
298 2 => 'L + R (stereo)',
299 3 => '(L+R) + (L-R) (sum-difference)',
300 4 => 'LT + RT (left and right total)',
303 7 => 'C + L + R + S',
304 8 => 'L + R + SL + SR',
305 9 => 'C + L + R + SL + SR',
306 10 => 'CL + CR + L + R + SL + SR',
307 11 => 'C + L + R+ LR + RR + OV',
308 12 => 'CF + CR + LF + RF + LR + RR',
309 13 => 'CL + C + CR + L + R + SL + SR',
310 14 => 'CL + CR + L + R + SL1 + SL2 + SR1 + SR2',
311 15 => 'CL + C+ CR + L + R + SL + S + SR',
313 return (isset($lookup[$index]) ?
$lookup[$index] : 'user-defined');
318 * @param int $version
322 public static function dialogNormalization($index, $version) {
328 return 0 - 16 - $index;