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 /////////////////////////////////////////////////////////////////
17 if (!defined('GETID3_INCLUDEPATH')) { // prevent path-exposing attacks that access modules directly on public webservers
22 * @tutorial http://wiki.multimedia.cx/index.php?title=DTS
24 class getid3_dts
extends getid3_handler
27 * Default DTS syncword used in native .cpt or .dts formats.
29 const syncword
= "\x7F\xFE\x80\x01";
34 private $readBinDataOffset = 0;
37 * Possible syncwords indicating bitstream encoding.
39 public static $syncwords = array(
40 0 => "\x7F\xFE\x80\x01", // raw big-endian
41 1 => "\xFE\x7F\x01\x80", // raw little-endian
42 2 => "\x1F\xFF\xE8\x00", // 14-bit big-endian
43 3 => "\xFF\x1F\x00\xE8"); // 14-bit little-endian
48 public function Analyze() {
49 $info = &$this->getid3
->info
;
50 $info['fileformat'] = 'dts';
52 $this->fseek($info['avdataoffset']);
53 $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
56 $sync = substr($DTSheader, 0, 4);
57 if (($encoding = array_search($sync, self
::$syncwords)) !== false) {
59 $info['dts']['raw']['magic'] = $sync;
60 $this->readBinDataOffset
= 32;
62 } elseif ($this->isDependencyFor('matroska')) {
64 // Matroska contains DTS without syncword encoded as raw big-endian format
66 $this->readBinDataOffset
= 0;
70 unset($info['fileformat']);
71 return $this->error('Expecting "'.implode('| ', array_map('getid3_lib::PrintHexBytes', self
::$syncwords)).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib
::PrintHexBytes($sync).'"');
77 for ($word_offset = 0; $word_offset <= strlen($DTSheader); $word_offset +
= 2) {
79 case 0: // raw big-endian
80 $fhBS .= getid3_lib
::BigEndian2Bin( substr($DTSheader, $word_offset, 2) );
82 case 1: // raw little-endian
83 $fhBS .= getid3_lib
::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2)));
85 case 2: // 14-bit big-endian
86 $fhBS .= substr(getid3_lib
::BigEndian2Bin( substr($DTSheader, $word_offset, 2) ), 2, 14);
88 case 3: // 14-bit little-endian
89 $fhBS .= substr(getid3_lib
::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2))), 2, 14);
94 $info['dts']['raw']['frame_type'] = $this->readBinData($fhBS, 1);
95 $info['dts']['raw']['deficit_samples'] = $this->readBinData($fhBS, 5);
96 $info['dts']['flags']['crc_present'] = (bool) $this->readBinData($fhBS, 1);
97 $info['dts']['raw']['pcm_sample_blocks'] = $this->readBinData($fhBS, 7);
98 $info['dts']['raw']['frame_byte_size'] = $this->readBinData($fhBS, 14);
99 $info['dts']['raw']['channel_arrangement'] = $this->readBinData($fhBS, 6);
100 $info['dts']['raw']['sample_frequency'] = $this->readBinData($fhBS, 4);
101 $info['dts']['raw']['bitrate'] = $this->readBinData($fhBS, 5);
102 $info['dts']['flags']['embedded_downmix'] = (bool) $this->readBinData($fhBS, 1);
103 $info['dts']['flags']['dynamicrange'] = (bool) $this->readBinData($fhBS, 1);
104 $info['dts']['flags']['timestamp'] = (bool) $this->readBinData($fhBS, 1);
105 $info['dts']['flags']['auxdata'] = (bool) $this->readBinData($fhBS, 1);
106 $info['dts']['flags']['hdcd'] = (bool) $this->readBinData($fhBS, 1);
107 $info['dts']['raw']['extension_audio'] = $this->readBinData($fhBS, 3);
108 $info['dts']['flags']['extended_coding'] = (bool) $this->readBinData($fhBS, 1);
109 $info['dts']['flags']['audio_sync_insertion'] = (bool) $this->readBinData($fhBS, 1);
110 $info['dts']['raw']['lfe_effects'] = $this->readBinData($fhBS, 2);
111 $info['dts']['flags']['predictor_history'] = (bool) $this->readBinData($fhBS, 1);
112 if ($info['dts']['flags']['crc_present']) {
113 $info['dts']['raw']['crc16'] = $this->readBinData($fhBS, 16);
115 $info['dts']['flags']['mri_perfect_reconst'] = (bool) $this->readBinData($fhBS, 1);
116 $info['dts']['raw']['encoder_soft_version'] = $this->readBinData($fhBS, 4);
117 $info['dts']['raw']['copy_history'] = $this->readBinData($fhBS, 2);
118 $info['dts']['raw']['bits_per_sample'] = $this->readBinData($fhBS, 2);
119 $info['dts']['flags']['surround_es'] = (bool) $this->readBinData($fhBS, 1);
120 $info['dts']['flags']['front_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
121 $info['dts']['flags']['surround_sum_diff'] = (bool) $this->readBinData($fhBS, 1);
122 $info['dts']['raw']['dialog_normalization'] = $this->readBinData($fhBS, 4);
125 $info['dts']['bitrate'] = self
::bitrateLookup($info['dts']['raw']['bitrate']);
126 $info['dts']['bits_per_sample'] = self
::bitPerSampleLookup($info['dts']['raw']['bits_per_sample']);
127 $info['dts']['sample_rate'] = self
::sampleRateLookup($info['dts']['raw']['sample_frequency']);
128 $info['dts']['dialog_normalization'] = self
::dialogNormalization($info['dts']['raw']['dialog_normalization'], $info['dts']['raw']['encoder_soft_version']);
129 $info['dts']['flags']['lossless'] = (($info['dts']['raw']['bitrate'] == 31) ?
true : false);
130 $info['dts']['bitrate_mode'] = (($info['dts']['raw']['bitrate'] == 30) ?
'vbr' : 'cbr');
131 $info['dts']['channels'] = self
::numChannelsLookup($info['dts']['raw']['channel_arrangement']);
132 $info['dts']['channel_arrangement'] = self
::channelArrangementLookup($info['dts']['raw']['channel_arrangement']);
134 $info['audio']['dataformat'] = 'dts';
135 $info['audio']['lossless'] = $info['dts']['flags']['lossless'];
136 $info['audio']['bitrate_mode'] = $info['dts']['bitrate_mode'];
137 $info['audio']['bits_per_sample'] = $info['dts']['bits_per_sample'];
138 $info['audio']['sample_rate'] = $info['dts']['sample_rate'];
139 $info['audio']['channels'] = $info['dts']['channels'];
140 $info['audio']['bitrate'] = $info['dts']['bitrate'];
141 if (isset($info['avdataend']) && !empty($info['dts']['bitrate']) && is_numeric($info['dts']['bitrate'])) {
142 $info['playtime_seconds'] = ($info['avdataend'] - $info['avdataoffset']) / ($info['dts']['bitrate'] / 8);
143 if (($encoding == 2) ||
($encoding == 3)) {
144 // 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
145 $info['playtime_seconds'] *= (14 / 16);
157 private function readBinData($bin, $length) {
158 $data = substr($bin, $this->readBinDataOffset
, $length);
159 $this->readBinDataOffset +
= $length;
161 return bindec($data);
167 * @return int|string|false
169 public static function bitrateLookup($index) {
170 static $lookup = array(
204 return (isset($lookup[$index]) ?
$lookup[$index] : false);
210 * @return int|string|false
212 public static function sampleRateLookup($index) {
213 static $lookup = array(
231 return (isset($lookup[$index]) ?
$lookup[$index] : false);
239 public static function bitPerSampleLookup($index) {
240 static $lookup = array(
246 return (isset($lookup[$index]) ?
$lookup[$index] : false);
254 public static function numChannelsLookup($index) {
289 public static function channelArrangementLookup($index) {
290 static $lookup = array(
292 1 => 'A + B (dual mono)',
293 2 => 'L + R (stereo)',
294 3 => '(L+R) + (L-R) (sum-difference)',
295 4 => 'LT + RT (left and right total)',
298 7 => 'C + L + R + S',
299 8 => 'L + R + SL + SR',
300 9 => 'C + L + R + SL + SR',
301 10 => 'CL + CR + L + R + SL + SR',
302 11 => 'C + L + R+ LR + RR + OV',
303 12 => 'CF + CR + LF + RF + LR + RR',
304 13 => 'CL + C + CR + L + R + SL + SR',
305 14 => 'CL + CR + L + R + SL1 + SL2 + SR1 + SR2',
306 15 => 'CL + C+ CR + L + R + SL + S + SR',
308 return (isset($lookup[$index]) ?
$lookup[$index] : 'user-defined');
313 * @param int $version
317 public static function dialogNormalization($index, $version) {
322 return 0 - 16 - $index;