ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
Public Member Functions | Static Public Member Functions | Data Fields | Static Public Attributes | Private Member Functions | Private Attributes
getid3_dts Class Reference

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g // More...

+ Inheritance diagram for getid3_dts:
+ Collaboration diagram for getid3_dts:

Public Member Functions

 Analyze ()
 
- Public Member Functions inherited from getid3_handler
 __construct (getID3 $getid3, $call_module=null)
 
 Analyze ()
 
 AnalyzeString ($string)
 
 setStringMode ($string)
 
 saveAttachment ($name, $offset, $length, $image_mime=null)
 

Static Public Member Functions

static bitrateLookup ($index)
 
static sampleRateLookup ($index)
 
static bitPerSampleLookup ($index)
 
static numChannelsLookup ($index)
 
static channelArrangementLookup ($index)
 
static dialogNormalization ($index, $version)
 

Data Fields

const syncword = "\x7F\xFE\x80\x01"
 Default DTS syncword used in native .cpt or .dts formats. More...
 

Static Public Attributes

static $syncwords
 Possible syncwords indicating bitstream encoding. More...
 

Private Member Functions

 readBinData ($bin, $length)
 

Private Attributes

 $readBinDataOffset = 0
 

Additional Inherited Members

- Protected Member Functions inherited from getid3_handler
 ftell ()
 
 fread ($bytes)
 
 fseek ($bytes, $whence=SEEK_SET)
 
 feof ()
 
 isDependencyFor ($module)
 
 error ($text)
 
 warning ($text)
 
 notice ($text)
 
- Protected Attributes inherited from getid3_handler
 $getid3
 
 $data_string_flag = false
 
 $data_string = ''
 
 $data_string_position = 0
 
 $data_string_length = 0
 

Detailed Description

getID3() by James Heinrich info@.nosp@m.geti.nosp@m.d3.or.nosp@m.g //

@tutorial http://wiki.multimedia.cx/index.php?title=DTS

Definition at line 21 of file module.audio.dts.php.

Member Function Documentation

◆ Analyze()

getid3_dts::Analyze ( )

Reimplemented from getid3_handler.

Definition at line 39 of file module.audio.dts.php.

39 {
40 $info = &$this->getid3->info;
41 $info['fileformat'] = 'dts';
42
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
45
46 // check syncword
47 $sync = substr($DTSheader, 0, 4);
48 if (($encoding = array_search($sync, self::$syncwords)) !== false) {
49
50 $info['dts']['raw']['magic'] = $sync;
51 $this->readBinDataOffset = 32;
52
53 } elseif ($this->isDependencyFor('matroska')) {
54
55 // Matroska contains DTS without syncword encoded as raw big-endian format
56 $encoding = 0;
57 $this->readBinDataOffset = 0;
58
59 } else {
60
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).'"');
63
64 }
65
66 // decode header
67 $fhBS = '';
68 for ($word_offset = 0; $word_offset <= strlen($DTSheader); $word_offset += 2) {
69 switch ($encoding) {
70 case 0: // raw big-endian
71 $fhBS .= getid3_lib::BigEndian2Bin( substr($DTSheader, $word_offset, 2) );
72 break;
73 case 1: // raw little-endian
74 $fhBS .= getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2)));
75 break;
76 case 2: // 14-bit big-endian
77 $fhBS .= substr(getid3_lib::BigEndian2Bin( substr($DTSheader, $word_offset, 2) ), 2, 14);
78 break;
79 case 3: // 14-bit little-endian
80 $fhBS .= substr(getid3_lib::BigEndian2Bin(strrev(substr($DTSheader, $word_offset, 2))), 2, 14);
81 break;
82 }
83 }
84
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);
105 }
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);
114
115
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']);
124
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);
137 }
138 }
139 return true;
140 }
getid3_dts\channelArrangementLookup
static channelArrangementLookup($index)
Definition: module.audio.dts.php:257
getid3_dts\sampleRateLookup
static sampleRateLookup($index)
Definition: module.audio.dts.php:187
getid3_dts\bitPerSampleLookup
static bitPerSampleLookup($index)
Definition: module.audio.dts.php:209
getid3_dts\numChannelsLookup
static numChannelsLookup($index)
Definition: module.audio.dts.php:219
getid3_dts\readBinData
readBinData($bin, $length)
Definition: module.audio.dts.php:142
getid3_dts\bitrateLookup
static bitrateLookup($index)
Definition: module.audio.dts.php:149
getid3_dts\dialogNormalization
static dialogNormalization($index, $version)
Definition: module.audio.dts.php:279
getid3_handler\fseek
fseek($bytes, $whence=SEEK_SET)
Definition: getid3.php:1697
getid3_handler\isDependencyFor
isDependencyFor($module)
Definition: getid3.php:1734
getid3_handler\fread
fread($bytes)
Definition: getid3.php:1685
getid3_handler\error
error($text)
Definition: getid3.php:1738
getid3_lib\BigEndian2Bin
BigEndian2Bin($byteword)
Definition: getid3.lib.php:271
getid3_lib\PrintHexBytes
PrintHexBytes($string, $hex=true, $spaces=true, $htmlsafe=true)
Definition: getid3.lib.php:17
$info
$info
Definition: example_052.php:80

References $info, getid3_lib\BigEndian2Bin(), bitPerSampleLookup(), bitrateLookup(), channelArrangementLookup(), dialogNormalization(), getid3_handler\error(), getid3_handler\fread(), getid3_handler\fseek(), getid3_handler\isDependencyFor(), numChannelsLookup(), getid3_lib\PrintHexBytes(), readBinData(), and sampleRateLookup().

+ Here is the call graph for this function:

◆ bitPerSampleLookup()

static getid3_dts::bitPerSampleLookup (   $index)
static

Definition at line 209 of file module.audio.dts.php.

209 {
210 static $lookup = array(
211 0 => 16,
212 1 => 20,
213 2 => 24,
214 3 => 24,
215 );
216 return (isset($lookup[$index]) ? $lookup[$index] : false);
217 }

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ bitrateLookup()

static getid3_dts::bitrateLookup (   $index)
static

Definition at line 149 of file module.audio.dts.php.

149 {
150 static $lookup = array(
151 0 => 32000,
152 1 => 56000,
153 2 => 64000,
154 3 => 96000,
155 4 => 112000,
156 5 => 128000,
157 6 => 192000,
158 7 => 224000,
159 8 => 256000,
160 9 => 320000,
161 10 => 384000,
162 11 => 448000,
163 12 => 512000,
164 13 => 576000,
165 14 => 640000,
166 15 => 768000,
167 16 => 960000,
168 17 => 1024000,
169 18 => 1152000,
170 19 => 1280000,
171 20 => 1344000,
172 21 => 1408000,
173 22 => 1411200,
174 23 => 1472000,
175 24 => 1536000,
176 25 => 1920000,
177 26 => 2048000,
178 27 => 3072000,
179 28 => 3840000,
180 29 => 'open',
181 30 => 'variable',
182 31 => 'lossless',
183 );
184 return (isset($lookup[$index]) ? $lookup[$index] : false);
185 }

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ channelArrangementLookup()

static getid3_dts::channelArrangementLookup (   $index)
static

Definition at line 257 of file module.audio.dts.php.

257 {
258 static $lookup = array(
259 0 => 'A',
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)',
264 5 => 'C + L + R',
265 6 => 'L + R + S',
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',
275 );
276 return (isset($lookup[$index]) ? $lookup[$index] : 'user-defined');
277 }

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ dialogNormalization()

static getid3_dts::dialogNormalization (   $index,
  $version 
)
static

Definition at line 279 of file module.audio.dts.php.

279 {
280 switch ($version) {
281 case 7:
282 return 0 - $index;
283 break;
284 case 6:
285 return 0 - 16 - $index;
286 break;
287 }
288 return false;
289 }

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ numChannelsLookup()

static getid3_dts::numChannelsLookup (   $index)
static

Definition at line 219 of file module.audio.dts.php.

219 {
220 switch ($index) {
221 case 0:
222 return 1;
223 break;
224 case 1:
225 case 2:
226 case 3:
227 case 4:
228 return 2;
229 break;
230 case 5:
231 case 6:
232 return 3;
233 break;
234 case 7:
235 case 8:
236 return 4;
237 break;
238 case 9:
239 return 5;
240 break;
241 case 10:
242 case 11:
243 case 12:
244 return 6;
245 break;
246 case 13:
247 return 7;
248 break;
249 case 14:
250 case 15:
251 return 8;
252 break;
253 }
254 return false;
255 }

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ readBinData()

getid3_dts::readBinData (   $bin,
  $length 
)
private

Definition at line 142 of file module.audio.dts.php.

142 {
143 $data = substr($bin, $this->readBinDataOffset, $length);
144 $this->readBinDataOffset += $length;
145
146 return bindec($data);
147 }
$data
$data
Definition: example_011.php:126

References $data.

Referenced by Analyze().

+ Here is the caller graph for this function:

◆ sampleRateLookup()

static getid3_dts::sampleRateLookup (   $index)
static

Definition at line 187 of file module.audio.dts.php.

187 {
188 static $lookup = array(
189 0 => 'invalid',
190 1 => 8000,
191 2 => 16000,
192 3 => 32000,
193 4 => 'invalid',
194 5 => 'invalid',
195 6 => 11025,
196 7 => 22050,
197 8 => 44100,
198 9 => 'invalid',
199 10 => 'invalid',
200 11 => 12000,
201 12 => 24000,
202 13 => 48000,
203 14 => 'invalid',
204 15 => 'invalid',
205 );
206 return (isset($lookup[$index]) ? $lookup[$index] : false);
207 }

Referenced by Analyze().

+ Here is the caller graph for this function:

Field Documentation

◆ $readBinDataOffset

getid3_dts::$readBinDataOffset = 0
private

Definition at line 28 of file module.audio.dts.php.

◆ $syncwords

getid3_dts::$syncwords
static
Initial value:
= array(
0 => "\x7F\xFE\x80\x01",
1 => "\xFE\x7F\x01\x80",
2 => "\x1F\xFF\xE8\x00",
3 => "\xFF\x1F\x00\xE8")

Possible syncwords indicating bitstream encoding.

Definition at line 33 of file module.audio.dts.php.

Referenced by getid3_riff\ParseRIFF().

◆ syncword

const getid3_dts::syncword = "\x7F\xFE\x80\x01"

Default DTS syncword used in native .cpt or .dts formats.

Definition at line 26 of file module.audio.dts.php.

The documentation for this class was generated from the following file: