source: extensions/charlies_content/getid3/getid3/module.audio.voc.php @ 3318

Revision 3318, 10.0 KB checked in by vdigital, 11 years ago (diff)

+ Add Charlies' content to depository

  • Property svn:keywords set to Author Date Id Revision
Line 
1<?php
2// +----------------------------------------------------------------------+
3// | PHP version 5                                                        |
4// +----------------------------------------------------------------------+
5// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen                 |
6// +----------------------------------------------------------------------+
7// | This source file is subject to version 2 of the GPL license,         |
8// | that is bundled with this package in the file license.txt and is     |
9// | available through the world-wide-web at the following url:           |
10// | http://www.gnu.org/copyleft/gpl.html                                 |
11// +----------------------------------------------------------------------+
12// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org    |
13// +----------------------------------------------------------------------+
14// | Authors: James Heinrich <infoØgetid3*org>                            |
15// |          Allan Hansen <ahØartemis*dk>                                |
16// +----------------------------------------------------------------------+
17// | module.audio.voc.php                                                 |
18// | Module for analyzing Creative VOC Audio files.                       |
19// | dependencies: NONE                                                   |
20// +----------------------------------------------------------------------+
21//
22// $Id$
23
24       
25       
26class getid3_voc extends getid3_handler
27{
28
29    public function Analyze() {
30
31        $getid3 = $this->getid3;
32       
33        $original_av_data_offset = $getid3->info['avdataoffset'];
34       
35        fseek($getid3->fp, $getid3->info['avdataoffset'], SEEK_SET);
36        $voc_header= fread($getid3->fp, 26);
37
38        // Magic bytes: 'Creative Voice File'
39
40        $info_audio = &$getid3->info['audio'];
41        $getid3->info['voc'] = array ();
42        $info_voc = &$getid3->info['voc'];
43
44        $getid3->info['fileformat']    = 'voc';
45        $info_audio['dataformat']      = 'voc';
46        $info_audio['bitrate_mode']    = 'cbr';
47        $info_audio['lossless']        = true;
48        $info_audio['channels']        = 1;         // might be overriden below
49        $info_audio['bits_per_sample'] = 8;         // might be overriden below
50
51        // byte #     Description
52        // ------     ------------------------------------------
53        // 00-12      'Creative Voice File'
54        // 13         1A (eof to abort printing of file)
55        // 14-15      Offset of first datablock in .voc file (std 1A 00 in Intel Notation)
56        // 16-17      Version number (minor,major) (VOC-HDR puts 0A 01)
57        // 18-19      2's Comp of Ver. # + 1234h (VOC-HDR puts 29 11)
58
59        getid3_lib::ReadSequence('LittleEndian2Int', $info_voc['header'], $voc_header, 20,
60            array (
61                'datablock_offset' => 2, 
62                'minor_version'    => 1, 
63                'major_version'    => 1 
64            )
65        );
66
67        do {
68            $block_offset = ftell($getid3->fp);
69            $block_data   = fread($getid3->fp, 4);
70            $block_type   = ord($block_data{0});
71            $block_size   = getid3_lib::LittleEndian2Int(substr($block_data, 1, 3));
72            $this_block   = array ();
73
74            @$info_voc['blocktypes'][$block_type]++;
75           
76            switch ($block_type) {
77               
78                case 0:  // Terminator
79                    // do nothing, we'll break out of the loop down below
80                    break;
81
82                case 1:  // Sound data
83                    $block_data .= fread($getid3->fp, 2);
84                    if ($getid3->info['avdataoffset'] <= $original_av_data_offset) {
85                        $getid3->info['avdataoffset'] = ftell($getid3->fp);
86                    }
87                    fseek($getid3->fp, $block_size - 2, SEEK_CUR);
88
89                    getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4,
90                        array (
91                            'sample_rate_id'   => 1,
92                            'compression_type' => 1
93                        )
94                    );
95
96                    $this_block['compression_name'] = getid3_voc::VOCcompressionTypeLookup($this_block['compression_type']);
97                    if ($this_block['compression_type'] <= 3) {
98                        $info_voc['compressed_bits_per_sample'] = (int)(str_replace('-bit', '', $this_block['compression_name']));
99                    }
100
101                    // Less accurate sample_rate calculation than the Extended block (#8) data (but better than nothing if Extended Block is not available)
102                    if (empty($info_audio['sample_rate'])) {
103                        // SR byte = 256 - (1000000 / sample_rate)
104                        $info_audio['sample_rate'] = (int)floor((1000000 / (256 - $this_block['sample_rate_id'])) / $info_audio['channels']);
105                    }
106                    break;
107
108                case 2:  // Sound continue
109                case 3:  // Silence
110                case 4:  // Marker
111                case 6:  // Repeat
112                case 7:  // End repeat
113                    // nothing useful, just skip
114                    fseek($getid3->fp, $block_size, SEEK_CUR);
115                    break;
116
117                case 8:  // Extended
118                    $block_data .= fread($getid3->fp, 4);
119
120                    //00-01  Time Constant:
121                    //   Mono: 65536 - (256000000 / sample_rate)
122                    // Stereo: 65536 - (256000000 / (sample_rate * 2))
123                    getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4,
124                        array (
125                            'time_constant' => 2, 
126                            'pack_method'   => 1, 
127                            'stereo'        => 1       
128                        )
129                    );
130                    $this_block['stereo']      = (bool)$this_block['stereo'];
131                   
132                    $info_audio['channels']    = ($this_block['stereo'] ? 2 : 1);
133                    $info_audio['sample_rate'] = (int)floor((256000000 / (65536 - $this_block['time_constant'])) / $info_audio['channels']);
134                    break;
135
136                case 9:  // data block that supersedes blocks 1 and 8. Used for stereo, 16 bit
137                    $block_data .= fread($getid3->fp, 12);
138                    if ($getid3->info['avdataoffset'] <= $original_av_data_offset) {
139                        $getid3->info['avdataoffset'] = ftell($getid3->fp);
140                    }
141                    fseek($getid3->fp, $block_size - 12, SEEK_CUR);
142
143                    getid3_lib::ReadSequence('LittleEndian2Int', $this_block, $block_data, 4,
144                        array (
145                            'sample_rate'     => 4,
146                            'bits_per_sample' => 1,
147                            'channels'        => 1, 
148                            'wFormat'         => 2 
149                        )
150                    );
151                   
152                    $this_block['compression_name'] = getid3_voc::VOCwFormatLookup($this_block['wFormat']);
153                    if (getid3_voc::VOCwFormatActualBitsPerSampleLookup($this_block['wFormat'])) {
154                        $info_voc['compressed_bits_per_sample'] = getid3_voc::VOCwFormatActualBitsPerSampleLookup($this_block['wFormat']);
155                    }
156
157                    $info_audio['sample_rate']     = $this_block['sample_rate'];
158                    $info_audio['bits_per_sample'] = $this_block['bits_per_sample'];
159                    $info_audio['channels']        = $this_block['channels'];
160                    break;
161
162                default:
163                    $getid3->warning('Unhandled block type "'.$block_type.'" at offset '.$block_offset);
164                    fseek($getid3->fp, $block_size, SEEK_CUR);
165                    break;
166            }
167
168            if (!empty($this_block)) {
169                $this_block['block_offset']  = $block_offset;
170                $this_block['block_size']    = $block_size;
171                $this_block['block_type_id'] = $block_type;
172                $info_voc['blocks'][] = $this_block;
173            }
174
175        } while (!feof($getid3->fp) && ($block_type != 0));
176
177        // Terminator block doesn't have size field, so seek back 3 spaces
178        fseek($getid3->fp, -3, SEEK_CUR);
179
180        ksort($info_voc['blocktypes']);
181
182        if (!empty($info_voc['compressed_bits_per_sample'])) {
183            $getid3->info['playtime_seconds'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / ($info_voc['compressed_bits_per_sample'] * $info_audio['channels'] * $info_audio['sample_rate']);
184            $info_audio['bitrate'] = (($getid3->info['avdataend'] - $getid3->info['avdataoffset']) * 8) / $getid3->info['playtime_seconds'];
185        }
186
187        return true;
188    }
189
190
191
192    public static function VOCcompressionTypeLookup($index) {
193       
194        static $lookup = array (
195            0 => '8-bit',
196            1 => '4-bit',
197            2 => '2.6-bit',
198            3 => '2-bit'
199        );
200        return (isset($lookup[$index]) ? $lookup[$index] : 'Multi DAC ('.($index - 3).') channels');
201    }
202
203
204
205    public static function VOCwFormatLookup($index) {
206       
207        static $lookup = array (
208            0x0000 => '8-bit unsigned PCM',
209            0x0001 => 'Creative 8-bit to 4-bit ADPCM',
210            0x0002 => 'Creative 8-bit to 3-bit ADPCM',
211            0x0003 => 'Creative 8-bit to 2-bit ADPCM',
212            0x0004 => '16-bit signed PCM',
213            0x0006 => 'CCITT a-Law',
214            0x0007 => 'CCITT u-Law',
215            0x2000 => 'Creative 16-bit to 4-bit ADPCM'
216        );
217        return (isset($lookup[$index]) ? $lookup[$index] : false);
218    }
219
220
221
222    public static function VOCwFormatActualBitsPerSampleLookup($index) {
223       
224        static $lookup = array (
225            0x0000 => 8,
226            0x0001 => 4,
227            0x0002 => 3,
228            0x0003 => 2,
229            0x0004 => 16,
230            0x0006 => 8,
231            0x0007 => 8,
232            0x2000 => 4
233        );
234        return (isset($lookup[$index]) ? $lookup[$index] : false);
235    }
236
237}
238
239
240?>
Note: See TracBrowser for help on using the repository browser.