ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
module.audio.dss.php
Go to the documentation of this file.
1<?php
4// available at http://getid3.sourceforge.net //
5// or http://www.getid3.org //
6// also https://github.com/JamesHeinrich/getID3 //
8// See readme.txt for more details //
10// //
11// module.audio.dss.php //
12// module for analyzing Digital Speech Standard (DSS) files //
13// dependencies: NONE //
14// ///
16
17
19{
20
21 public function Analyze() {
22 $info = &$this->getid3->info;
23
24 $this->fseek($info['avdataoffset']);
25 $DSSheader = $this->fread(1540);
26
27 if (!preg_match('#^(\x02|\x03)ds[s2]#', $DSSheader)) {
28 $info['error'][] = 'Expecting "[02-03] 64 73 [73|32]" at offset '.$info['avdataoffset'].', found "'.getid3_lib::PrintHexBytes(substr($DSSheader, 0, 4)).'"';
29 return false;
30 }
31
32 // some structure information taken from http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm
33 $info['encoding'] = 'ISO-8859-1'; // not certain, but assumed
34 $info['dss'] = array();
35
36 $info['fileformat'] = 'dss';
37 $info['mime_type'] = 'audio/x-'.substr($DSSheader, 1, 3); // "audio/x-dss" or "audio/x-ds2"
38 $info['audio']['dataformat'] = substr($DSSheader, 1, 3); // "dss" or "ds2"
39 $info['audio']['bitrate_mode'] = 'cbr';
40
41 $info['dss']['version'] = ord(substr($DSSheader, 0, 1));
42 $info['dss']['hardware'] = trim(substr($DSSheader, 12, 16)); // identification string for hardware used to create the file, e.g. "DPM 9600", "DS2400"
43 $info['dss']['unknown1'] = getid3_lib::LittleEndian2Int(substr($DSSheader, 28, 4));
44 // 32-37 = "FE FF FE FF F7 FF" in all the sample files I've seen
45 $info['dss']['date_create'] = $this->DSSdateStringToUnixDate(substr($DSSheader, 38, 12));
46 $info['dss']['date_complete'] = $this->DSSdateStringToUnixDate(substr($DSSheader, 50, 12));
47 $info['dss']['playtime_sec'] = intval((substr($DSSheader, 62, 2) * 3600) + (substr($DSSheader, 64, 2) * 60) + substr($DSSheader, 66, 2)); // approximate file playtime in HHMMSS
48 $info['dss']['playtime_ms'] = getid3_lib::LittleEndian2Int(substr($DSSheader, 512, 4)); // exact file playtime in milliseconds. Has also been observed at offset 530 in one sample file, with something else (unknown) at offset 512
49 $info['dss']['priority'] = ord(substr($DSSheader, 793, 1));
50 $info['dss']['comments'] = trim(substr($DSSheader, 798, 100));
51 $info['dss']['sample_rate_index'] = ord(substr($DSSheader, 1538, 1)); // this isn't certain, this may or may not be where the sample rate info is stored, but it seems consistent on my small selection of sample files
52
53 $info['audio']['bits_per_sample'] = 16; // maybe, maybe not -- most compressed audio formats don't have a fixed bits-per-sample value, but this is a reasonable approximation
54 $info['audio']['sample_rate'] = $this->DSSsampleRateLookup($info['dss']['sample_rate_index']);
55 $info['audio']['channels'] = 1;
56
57 $info['playtime_seconds'] = $info['dss']['playtime_ms'] / 1000;
58 if (floor($info['dss']['playtime_ms'] / 1000) != $info['dss']['playtime_sec']) {
59 // *should* just be playtime_ms / 1000 but at least one sample file has playtime_ms at offset 530 instead of offset 512, so safety check
60 $info['playtime_seconds'] = $info['dss']['playtime_sec'];
61 $this->getid3->warning('playtime_ms ('.number_format($info['dss']['playtime_ms'] / 1000, 3).') does not match playtime_sec ('.number_format($info['dss']['playtime_sec']).') - using playtime_sec value');
62 }
63 $info['audio']['bitrate'] = ($info['filesize'] * 8) / $info['playtime_seconds'];
64
65 return true;
66 }
67
68 public function DSSdateStringToUnixDate($datestring) {
69 $y = substr($datestring, 0, 2);
70 $m = substr($datestring, 2, 2);
71 $d = substr($datestring, 4, 2);
72 $h = substr($datestring, 6, 2);
73 $i = substr($datestring, 8, 2);
74 $s = substr($datestring, 10, 2);
75 $y += (($y < 95) ? 2000 : 1900);
76 return mktime($h, $i, $s, $m, $d, $y);
77 }
78
79 public function DSSsampleRateLookup($sample_rate_index) {
80 static $dssSampleRateLookup = array(
81 0x0A => 16000,
82 0x0C => 11025,
83 0x0D => 12000,
84 0x15 => 8000,
85 );
86 if (!array_key_exists($sample_rate_index, $dssSampleRateLookup)) {
87 $this->getid3->warning('unknown sample_rate_index: '.$sample_rate_index);
88 return false;
89 }
90 return $dssSampleRateLookup[$sample_rate_index];
91 }
92
93}
getID3() by James Heinrich info@getid3.org //
DSSdateStringToUnixDate($datestring)
DSSsampleRateLookup($sample_rate_index)
fseek($bytes, $whence=SEEK_SET)
Definition: getid3.php:1697
fread($bytes)
Definition: getid3.php:1685
LittleEndian2Int($byteword, $signed=false)
Definition: getid3.lib.php:266
PrintHexBytes($string, $hex=true, $spaces=true, $htmlsafe=true)
Definition: getid3.lib.php:17
$y
Definition: example_007.php:83
$h
$info
Definition: example_052.php:80