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.voc.php //
12 // module for analyzing Creative VOC Audio files //
13 // dependencies: NONE //
15 /////////////////////////////////////////////////////////////////
18 class getid3_voc
extends getid3_handler
23 public function Analyze() {
24 $info = &$this->getid3
->info
;
26 $OriginalAVdataOffset = $info['avdataoffset'];
27 $this->fseek($info['avdataoffset']);
28 $VOCheader = $this->fread(26);
30 $magic = 'Creative Voice File';
31 if (substr($VOCheader, 0, 19) != $magic) {
32 $this->error('Expecting "'.getid3_lib
::PrintHexBytes($magic).'" at offset '.$info['avdataoffset'].', found "'.getid3_lib
::PrintHexBytes(substr($VOCheader, 0, 19)).'"');
37 $thisfile_audio = &$info['audio'];
38 $info['voc'] = array();
39 $thisfile_voc = &$info['voc'];
41 $info['fileformat'] = 'voc';
42 $thisfile_audio['dataformat'] = 'voc';
43 $thisfile_audio['bitrate_mode'] = 'cbr';
44 $thisfile_audio['lossless'] = true;
45 $thisfile_audio['channels'] = 1; // might be overriden below
46 $thisfile_audio['bits_per_sample'] = 8; // might be overriden below
49 // ------ ------------------------------------------
50 // 00-12 'Creative Voice File'
51 // 13 1A (eof to abort printing of file)
52 // 14-15 Offset of first datablock in .voc file (std 1A 00 in Intel Notation)
53 // 16-17 Version number (minor,major) (VOC-HDR puts 0A 01)
54 // 18-19 2's Comp of Ver. # + 1234h (VOC-HDR puts 29 11)
56 $thisfile_voc['header']['datablock_offset'] = getid3_lib
::LittleEndian2Int(substr($VOCheader, 20, 2));
57 $thisfile_voc['header']['minor_version'] = getid3_lib
::LittleEndian2Int(substr($VOCheader, 22, 1));
58 $thisfile_voc['header']['major_version'] = getid3_lib
::LittleEndian2Int(substr($VOCheader, 23, 1));
62 $BlockOffset = $this->ftell();
63 $BlockData = $this->fread(4);
64 $BlockType = ord($BlockData{0});
65 $BlockSize = getid3_lib
::LittleEndian2Int(substr($BlockData, 1, 3));
68 getid3_lib
::safe_inc($thisfile_voc['blocktypes'][$BlockType], 1);
71 // do nothing, we'll break out of the loop down below
75 $BlockData .= $this->fread(2);
76 if ($info['avdataoffset'] <= $OriginalAVdataOffset) {
77 $info['avdataoffset'] = $this->ftell();
79 $this->fseek($BlockSize - 2, SEEK_CUR
);
81 $ThisBlock['sample_rate_id'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 4, 1));
82 $ThisBlock['compression_type'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 5, 1));
84 $ThisBlock['compression_name'] = $this->VOCcompressionTypeLookup($ThisBlock['compression_type']);
85 if ($ThisBlock['compression_type'] <= 3) {
86 $thisfile_voc['compressed_bits_per_sample'] = getid3_lib
::CastAsInt(str_replace('-bit', '', $ThisBlock['compression_name']));
89 // Less accurate sample_rate calculation than the Extended block (#8) data (but better than nothing if Extended Block is not available)
90 if (empty($thisfile_audio['sample_rate'])) {
91 // SR byte = 256 - (1000000 / sample_rate)
92 $thisfile_audio['sample_rate'] = getid3_lib
::trunc((1000000 / (256 - $ThisBlock['sample_rate_id'])) / $thisfile_audio['channels']);
96 case 2: // Sound continue
100 case 7: // End repeat
101 // nothing useful, just skip
102 $this->fseek($BlockSize, SEEK_CUR
);
106 $BlockData .= $this->fread(4);
108 //00-01 Time Constant:
109 // Mono: 65536 - (256000000 / sample_rate)
110 // Stereo: 65536 - (256000000 / (sample_rate * 2))
111 $ThisBlock['time_constant'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 4, 2));
112 $ThisBlock['pack_method'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 6, 1));
113 $ThisBlock['stereo'] = (bool) getid3_lib
::LittleEndian2Int(substr($BlockData, 7, 1));
115 $thisfile_audio['channels'] = ($ThisBlock['stereo'] ?
2 : 1);
116 $thisfile_audio['sample_rate'] = getid3_lib
::trunc((256000000 / (65536 - $ThisBlock['time_constant'])) / $thisfile_audio['channels']);
119 case 9: // data block that supersedes blocks 1 and 8. Used for stereo, 16 bit
120 $BlockData .= $this->fread(12);
121 if ($info['avdataoffset'] <= $OriginalAVdataOffset) {
122 $info['avdataoffset'] = $this->ftell();
124 $this->fseek($BlockSize - 12, SEEK_CUR
);
126 $ThisBlock['sample_rate'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 4, 4));
127 $ThisBlock['bits_per_sample'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 8, 1));
128 $ThisBlock['channels'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 9, 1));
129 $ThisBlock['wFormat'] = getid3_lib
::LittleEndian2Int(substr($BlockData, 10, 2));
131 $ThisBlock['compression_name'] = $this->VOCwFormatLookup($ThisBlock['wFormat']);
132 if ($this->VOCwFormatActualBitsPerSampleLookup($ThisBlock['wFormat'])) {
133 $thisfile_voc['compressed_bits_per_sample'] = $this->VOCwFormatActualBitsPerSampleLookup($ThisBlock['wFormat']);
136 $thisfile_audio['sample_rate'] = $ThisBlock['sample_rate'];
137 $thisfile_audio['bits_per_sample'] = $ThisBlock['bits_per_sample'];
138 $thisfile_audio['channels'] = $ThisBlock['channels'];
142 $this->warning('Unhandled block type "'.$BlockType.'" at offset '.$BlockOffset);
143 $this->fseek($BlockSize, SEEK_CUR
);
147 if (!empty($ThisBlock)) {
148 $ThisBlock['block_offset'] = $BlockOffset;
149 $ThisBlock['block_size'] = $BlockSize;
150 $ThisBlock['block_type_id'] = $BlockType;
151 $thisfile_voc['blocks'][] = $ThisBlock;
154 } while (!feof($this->getid3
->fp
) && ($BlockType != 0));
156 // Terminator block doesn't have size field, so seek back 3 spaces
157 $this->fseek(-3, SEEK_CUR
);
159 ksort($thisfile_voc['blocktypes']);
161 if (!empty($thisfile_voc['compressed_bits_per_sample'])) {
162 $info['playtime_seconds'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / ($thisfile_voc['compressed_bits_per_sample'] * $thisfile_audio['channels'] * $thisfile_audio['sample_rate']);
163 $thisfile_audio['bitrate'] = (($info['avdataend'] - $info['avdataoffset']) * 8) / $info['playtime_seconds'];
174 public function VOCcompressionTypeLookup($index) {
175 static $VOCcompressionTypeLookup = array(
181 return (isset($VOCcompressionTypeLookup[$index]) ?
$VOCcompressionTypeLookup[$index] : 'Multi DAC ('.($index - 3).') channels');
187 * @return string|false
189 public function VOCwFormatLookup($index) {
190 static $VOCwFormatLookup = array(
191 0x0000 => '8-bit unsigned PCM',
192 0x0001 => 'Creative 8-bit to 4-bit ADPCM',
193 0x0002 => 'Creative 8-bit to 3-bit ADPCM',
194 0x0003 => 'Creative 8-bit to 2-bit ADPCM',
195 0x0004 => '16-bit signed PCM',
196 0x0006 => 'CCITT a-Law',
197 0x0007 => 'CCITT u-Law',
198 0x2000 => 'Creative 16-bit to 4-bit ADPCM'
200 return (isset($VOCwFormatLookup[$index]) ?
$VOCwFormatLookup[$index] : false);
208 public function VOCwFormatActualBitsPerSampleLookup($index) {
209 static $VOCwFormatLookup = array(
219 return (isset($VOCwFormatLookup[$index]) ?
$VOCwFormatLookup[$index] : false);