diff e2gallerypro/e2upload/Backend/Assets/getid3/module.tag.id3v2.php @ 3:3f6b44aa6b35 judyates

[svn r4] added ability to buy stuff, from a Prints page, but it doesn't work well with the css, and it also has not been fitted into the perl make system.
author rlm
date Mon, 22 Feb 2010 08:02:39 -0500
parents
children
line wrap: on
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/e2gallerypro/e2upload/Backend/Assets/getid3/module.tag.id3v2.php	Mon Feb 22 08:02:39 2010 -0500
     1.3 @@ -0,0 +1,3280 @@
     1.4 +<?php
     1.5 +// +----------------------------------------------------------------------+
     1.6 +// | PHP version 5                                                        |
     1.7 +// +----------------------------------------------------------------------+
     1.8 +// | Copyright (c) 2002-2006 James Heinrich, Allan Hansen                 |
     1.9 +// +----------------------------------------------------------------------+
    1.10 +// | This source file is subject to version 2 of the GPL license,         |
    1.11 +// | that is bundled with this package in the file license.txt and is     |
    1.12 +// | available through the world-wide-web at the following url:           |
    1.13 +// | http://www.gnu.org/copyleft/gpl.html                                 |
    1.14 +// +----------------------------------------------------------------------+
    1.15 +// | getID3() - http://getid3.sourceforge.net or http://www.getid3.org    |
    1.16 +// +----------------------------------------------------------------------+
    1.17 +// | Authors: James Heinrich <infoØgetid3*org>                            |
    1.18 +// |          Allan Hansen <ahØartemis*dk>                                |
    1.19 +// +----------------------------------------------------------------------+
    1.20 +// | module.tag.id3v2.php                                                 |
    1.21 +// | module for analyzing ID3v2 tags                                      |
    1.22 +// | dependencies: module.tag.id3v1.php                                   |
    1.23 +// |               module.lib.image_size.php (optional)                   |
    1.24 +// |               zlib support in PHP (optional)                         |
    1.25 +// +----------------------------------------------------------------------+
    1.26 +//
    1.27 +// $Id: module.tag.id3v2.php,v 1.15 2006/12/03 23:47:29 ah Exp $
    1.28 +
    1.29 +
    1.30 +        
    1.31 +        
    1.32 +class getid3_id3v2 extends getid3_handler
    1.33 +{
    1.34 +
    1.35 +    public $option_starting_offset = 0;
    1.36 +
    1.37 +
    1.38 +    public function Analyze() {
    1.39 +
    1.40 +        $getid3 = $this->getid3;
    1.41 +        
    1.42 +        // dependency
    1.43 +        $getid3->include_module('tag.id3v1');
    1.44 +        
    1.45 +        if ($getid3->option_tags_images) {        
    1.46 +            $getid3->include_module('lib.image_size');
    1.47 +        }
    1.48 +
    1.49 +
    1.50 +        //    Overall tag structure:
    1.51 +        //        +-----------------------------+
    1.52 +        //        |      Header (10 bytes)      |
    1.53 +        //        +-----------------------------+
    1.54 +        //        |       Extended Header       |
    1.55 +        //        | (variable length, OPTIONAL) |
    1.56 +        //        +-----------------------------+
    1.57 +        //        |   Frames (variable length)  |
    1.58 +        //        +-----------------------------+
    1.59 +        //        |           Padding           |
    1.60 +        //        | (variable length, OPTIONAL) |
    1.61 +        //        +-----------------------------+
    1.62 +        //        | Footer (10 bytes, OPTIONAL) |
    1.63 +        //        +-----------------------------+
    1.64 +        //
    1.65 +        //    Header
    1.66 +        //        ID3v2/file identifier      "ID3"
    1.67 +        //        ID3v2 version              $04 00
    1.68 +        //        ID3v2 flags                (%ab000000 in v2.2, %abc00000 in v2.3, %abcd0000 in v2.4.x)
    1.69 +        //        ID3v2 size                 4 * %0xxxxxxx
    1.70 +
    1.71 +
    1.72 +        // shortcuts
    1.73 +        $getid3->info['id3v2']['header'] = true;
    1.74 +        $info_id3v2          = &$getid3->info['id3v2'];
    1.75 +        $info_id3v2['flags'] = array ();
    1.76 +        $info_id3v2_flags    = &$info_id3v2['flags'];
    1.77 +
    1.78 +
    1.79 +        $this->fseek($this->option_starting_offset, SEEK_SET);
    1.80 +        $header = $this->fread(10);
    1.81 +        if (substr($header, 0, 3) == 'ID3'  &&  strlen($header) == 10) {
    1.82 +
    1.83 +            $info_id3v2['majorversion'] = ord($header{3});
    1.84 +            $info_id3v2['minorversion'] = ord($header{4});
    1.85 +
    1.86 +            // shortcut
    1.87 +            $id3v2_major_version = &$info_id3v2['majorversion'];
    1.88 +
    1.89 +        } else {
    1.90 +            unset($getid3->info['id3v2']);
    1.91 +            return false;
    1.92 +
    1.93 +        }
    1.94 +
    1.95 +        if ($id3v2_major_version > 4) { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists)
    1.96 +            throw new getid3_exception('this script only parses up to ID3v2.4.x - this tag is ID3v2.'.$id3v2_major_version.'.'.$info_id3v2['minorversion']);
    1.97 +        }
    1.98 +
    1.99 +        $id3_flags = ord($header{5});
   1.100 +        switch ($id3v2_major_version) {
   1.101 +            case 2:
   1.102 +                // %ab000000 in v2.2
   1.103 +                $info_id3v2_flags['unsynch']     = (bool)($id3_flags & 0x80); // a - Unsynchronisation
   1.104 +                $info_id3v2_flags['compression'] = (bool)($id3_flags & 0x40); // b - Compression
   1.105 +                break;
   1.106 +
   1.107 +            case 3:
   1.108 +                // %abc00000 in v2.3
   1.109 +                $info_id3v2_flags['unsynch']     = (bool)($id3_flags & 0x80); // a - Unsynchronisation
   1.110 +                $info_id3v2_flags['exthead']     = (bool)($id3_flags & 0x40); // b - Extended header
   1.111 +                $info_id3v2_flags['experim']     = (bool)($id3_flags & 0x20); // c - Experimental indicator
   1.112 +                break;
   1.113 +
   1.114 +            case 4:
   1.115 +                // %abcd0000 in v2.4
   1.116 +                $info_id3v2_flags['unsynch']     = (bool)($id3_flags & 0x80); // a - Unsynchronisation
   1.117 +                $info_id3v2_flags['exthead']     = (bool)($id3_flags & 0x40); // b - Extended header
   1.118 +                $info_id3v2_flags['experim']     = (bool)($id3_flags & 0x20); // c - Experimental indicator
   1.119 +                $info_id3v2_flags['isfooter']    = (bool)($id3_flags & 0x10); // d - Footer present
   1.120 +                break;
   1.121 +        }
   1.122 +
   1.123 +        $info_id3v2['headerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($header, 6, 4)) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length
   1.124 +
   1.125 +        $info_id3v2['tag_offset_start'] = $this->option_starting_offset;
   1.126 +        $info_id3v2['tag_offset_end']   = $info_id3v2['tag_offset_start'] + $info_id3v2['headerlength'];
   1.127 +
   1.128 +
   1.129 +        // Frames
   1.130 +        
   1.131 +        //     All ID3v2 frames consists of one frame header followed by one or more
   1.132 +        //     fields containing the actual information. The header is always 10
   1.133 +        //     bytes and laid out as follows:
   1.134 +        //
   1.135 +        //     Frame ID      $xx xx xx xx  (four characters)
   1.136 +        //     Size      4 * %0xxxxxxx
   1.137 +        //     Flags         $xx xx
   1.138 +
   1.139 +        $size_of_frames = $info_id3v2['headerlength'] - 10; // not including 10-byte initial header
   1.140 +        if (@$info_id3v2['exthead']['length']) {
   1.141 +            $size_of_frames -= ($info_id3v2['exthead']['length'] + 4);
   1.142 +        }
   1.143 +        
   1.144 +        if (@$info_id3v2_flags['isfooter']) {
   1.145 +            $size_of_frames -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio
   1.146 +        }
   1.147 +        
   1.148 +        if ($size_of_frames > 0) {
   1.149 +            $frame_data = $this->fread($size_of_frames); // read all frames from file into $frame_data variable
   1.150 +
   1.151 +            //    if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x)
   1.152 +            if (@$info_id3v2_flags['unsynch'] && ($id3v2_major_version <= 3)) {
   1.153 +                $frame_data = str_replace("\xFF\x00", "\xFF", $frame_data);
   1.154 +            }
   1.155 +        
   1.156 +            //        [in ID3v2.4.0] Unsynchronisation [S:6.1] is done on frame level, instead
   1.157 +            //        of on tag level, making it easier to skip frames, increasing the streamability
   1.158 +            //        of the tag. The unsynchronisation flag in the header [S:3.1] indicates that
   1.159 +            //        there exists an unsynchronised frame, while the new unsynchronisation flag in
   1.160 +            //        the frame header [S:4.1.2] indicates unsynchronisation.
   1.161 +
   1.162 +             //$frame_data_offset = 10 + (@$info_id3v2['exthead']['length'] ? $info_id3v2['exthead']['length'] + 4 : 0); // how many bytes into the stream - start from after the 10-byte header (and extended header length+4, if present)
   1.163 +             $frame_data_offset = 10; // how many bytes into the stream - start from after the 10-byte header
   1.164 +
   1.165 +             //    Extended Header
   1.166 +             if (@$info_id3v2_flags['exthead']) {
   1.167 +                     $extended_header_offset = 0;
   1.168 +
   1.169 +                 if ($id3v2_major_version == 3) {
   1.170 +
   1.171 +                     // v2.3 definition:
   1.172 +                     //Extended header size  $xx xx xx xx   // 32-bit integer
   1.173 +                     //Extended Flags        $xx xx
   1.174 +                     //     %x0000000 %00000000 // v2.3
   1.175 +                     //     x - CRC data present
   1.176 +                     //Size of padding       $xx xx xx xx
   1.177 +
   1.178 +                     $info_id3v2['exthead']['length'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 0);
   1.179 +                     $extended_header_offset += 4;
   1.180 +
   1.181 +                     $info_id3v2['exthead']['flag_bytes'] = 2;
   1.182 +                     $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
   1.183 +                     $extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
   1.184 +
   1.185 +                     $info_id3v2['exthead']['flags']['crc'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x8000);
   1.186 +
   1.187 +                     $info_id3v2['exthead']['padding_size'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
   1.188 +                     $extended_header_offset += 4;
   1.189 +
   1.190 +                     if ($info_id3v2['exthead']['flags']['crc']) {
   1.191 +                         $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4));
   1.192 +                         $extended_header_offset += 4;
   1.193 +                     }
   1.194 +                     $extended_header_offset += $info_id3v2['exthead']['padding_size'];
   1.195 +
   1.196 +                 } 
   1.197 +                 
   1.198 +                 elseif ($id3v2_major_version == 4) {
   1.199 +
   1.200 +                     // v2.4 definition:
   1.201 +                     //Extended header size   4 * %0xxxxxxx // 28-bit synchsafe integer
   1.202 +                     //Number of flag bytes       $01
   1.203 +                     //Extended Flags             $xx
   1.204 +                     //     %0bcd0000 // v2.4
   1.205 +                     //     b - Tag is an update
   1.206 +                     //         Flag data length       $00
   1.207 +                     //     c - CRC data present
   1.208 +                     //         Flag data length       $05
   1.209 +                     //         Total frame CRC    5 * %0xxxxxxx
   1.210 +                     //     d - Tag restrictions
   1.211 +                     //         Flag data length       $01
   1.212 +
   1.213 +                     $info_id3v2['exthead']['length']     = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 4), 1);
   1.214 +                     $extended_header_offset += 4;
   1.215 +
   1.216 +                     $info_id3v2['exthead']['flag_bytes'] = 1;
   1.217 +                     $info_id3v2['exthead']['flag_raw'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, $info_id3v2['exthead']['flag_bytes']));
   1.218 +                     $extended_header_offset += $info_id3v2['exthead']['flag_bytes'];
   1.219 +
   1.220 +                     $info_id3v2['exthead']['flags']['update']       = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x4000);
   1.221 +                     $info_id3v2['exthead']['flags']['crc']          = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x2000);
   1.222 +                     $info_id3v2['exthead']['flags']['restrictions'] = (bool) ($info_id3v2['exthead']['flag_raw'] & 0x1000);
   1.223 +
   1.224 +                     if ($info_id3v2['exthead']['flags']['crc']) {
   1.225 +                         $info_id3v2['exthead']['flag_data']['crc'] = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 5), 1);
   1.226 +                         $extended_header_offset += 5;
   1.227 +                     }
   1.228 +                     if ($info_id3v2['exthead']['flags']['restrictions']) {
   1.229 +                         // %ppqrrstt
   1.230 +                         $restrictions_raw = getid3_lib::BigEndian2Int(substr($frame_data, $extended_header_offset, 1));
   1.231 +                         $extended_header_offset += 1;
   1.232 +                         $info_id3v2['exthead']['flags']['restrictions']['tagsize']  = ($restrictions_raw && 0xC0) >> 6; // p - Tag size restrictions
   1.233 +                         $info_id3v2['exthead']['flags']['restrictions']['textenc']  = ($restrictions_raw && 0x20) >> 5; // q - Text encoding restrictions
   1.234 +                         $info_id3v2['exthead']['flags']['restrictions']['textsize'] = ($restrictions_raw && 0x18) >> 3; // r - Text fields size restrictions
   1.235 +                         $info_id3v2['exthead']['flags']['restrictions']['imgenc']   = ($restrictions_raw && 0x04) >> 2; // s - Image encoding restrictions
   1.236 +                             $info_id3v2['exthead']['flags']['restrictions']['imgsize']  = ($restrictions_raw && 0x03) >> 0; // t - Image size restrictions
   1.237 +                     }
   1.238 +
   1.239 +                 }
   1.240 +                 $frame_data_offset += $extended_header_offset;
   1.241 +                 $frame_data = substr($frame_data, $extended_header_offset);
   1.242 +             } // end extended header
   1.243 + 
   1.244 +            
   1.245 +            
   1.246 +            
   1.247 +            
   1.248 +            
   1.249 +            while (isset($frame_data) && (strlen($frame_data) > 0)) { // cycle through until no more frame data is left to parse
   1.250 +                if (strlen($frame_data) <= ($id3v2_major_version == 2 ? 6 : 10)) {
   1.251 +                    // insufficient room left in ID3v2 header for actual data - must be padding
   1.252 +                    $info_id3v2['padding']['start']  = $frame_data_offset;
   1.253 +                    $info_id3v2['padding']['length'] = strlen($frame_data);
   1.254 +                    $info_id3v2['padding']['valid']  = true;
   1.255 +                    for ($i = 0; $i < $info_id3v2['padding']['length']; $i++) {
   1.256 +                        if ($frame_data{$i} != "\x00") {
   1.257 +                            $info_id3v2['padding']['valid'] = false;
   1.258 +                            $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
   1.259 +                            $getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)');
   1.260 +                            break;
   1.261 +                        }
   1.262 +                    }
   1.263 +                    break; // skip rest of ID3v2 header
   1.264 +                }
   1.265 +                
   1.266 +                if ($id3v2_major_version == 2) {
   1.267 +                    // Frame ID  $xx xx xx (three characters)
   1.268 +                    // Size      $xx xx xx (24-bit integer)
   1.269 +                    // Flags     $xx xx
   1.270 +
   1.271 +                    $frame_header = substr($frame_data, 0, 6); // take next 6 bytes for header
   1.272 +                    $frame_data    = substr($frame_data, 6);    // and leave the rest in $frame_data
   1.273 +                    $frame_name   = substr($frame_header, 0, 3);
   1.274 +                    $frame_size   = getid3_lib::BigEndian2Int(substr($frame_header, 3, 3));
   1.275 +                    $frame_flags  = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs
   1.276 +
   1.277 +
   1.278 +                } elseif ($id3v2_major_version > 2) {
   1.279 +
   1.280 +                    // Frame ID  $xx xx xx xx (four characters)
   1.281 +                    // Size      $xx xx xx xx (32-bit integer in v2.3, 28-bit synchsafe in v2.4+)
   1.282 +                    // Flags     $xx xx
   1.283 +
   1.284 +                    $frame_header = substr($frame_data, 0, 10); // take next 10 bytes for header
   1.285 +                    $frame_data    = substr($frame_data, 10);    // and leave the rest in $frame_data
   1.286 +
   1.287 +                    $frame_name = substr($frame_header, 0, 4);
   1.288 +
   1.289 +                    if ($id3v2_major_version == 3) {
   1.290 +                        $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
   1.291 +
   1.292 +                    } else { // ID3v2.4+
   1.293 +                        $frame_size = getid3_lib::BigEndianSyncSafe2Int(substr($frame_header, 4, 4)); // 32-bit synchsafe integer (28-bit value)
   1.294 +                    }
   1.295 +
   1.296 +                    if ($frame_size < (strlen($frame_data) + 4)) {
   1.297 +                        $nextFrameID = substr($frame_data, $frame_size, 4);
   1.298 +                        if (getid3_id3v2::IsValidID3v2FrameName($nextFrameID, $id3v2_major_version)) {
   1.299 +                            // next frame is OK
   1.300 +                        } elseif (($frame_name == "\x00".'MP3') || ($frame_name == "\x00\x00".'MP') || ($frame_name == ' MP3') || ($frame_name == 'MP3e')) {
   1.301 +                            // MP3ext known broken frames - "ok" for the purposes of this test
   1.302 +                        } elseif (($id3v2_major_version == 4) && (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)), 4), 3))) {
   1.303 +                            $getid3->warning('ID3v2 tag written as ID3v2.4, but with non-synchsafe integers (ID3v2.3 style). Older versions of (Helium2; iTunes) are known culprits of this. Tag has been parsed as ID3v2.3');
   1.304 +                            $id3v2_major_version = 3;
   1.305 +                            $frame_size = getid3_lib::BigEndian2Int(substr($frame_header, 4, 4)); // 32-bit integer
   1.306 +                        }
   1.307 +                    }
   1.308 +
   1.309 +
   1.310 +                    $frame_flags = getid3_lib::BigEndian2Int(substr($frame_header, 8, 2));
   1.311 +                }
   1.312 +
   1.313 +                if ((($id3v2_major_version == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00")) {
   1.314 +                    // padding encountered
   1.315 +
   1.316 +                    $info_id3v2['padding']['start']  = $frame_data_offset;
   1.317 +                    $info_id3v2['padding']['length'] = strlen($frame_header) + strlen($frame_data);
   1.318 +                    $info_id3v2['padding']['valid']  = true;
   1.319 +                    
   1.320 +                    $len = strlen($frame_data);
   1.321 +                    for ($i = 0; $i < $len; $i++) {
   1.322 +                        if ($frame_data{$i} != "\x00") {
   1.323 +                            $info_id3v2['padding']['valid'] = false;
   1.324 +                            $info_id3v2['padding']['errorpos'] = $info_id3v2['padding']['start'] + $i;
   1.325 +                            $getid3->warning('Invalid ID3v2 padding found at offset '.$info_id3v2['padding']['errorpos'].' (the remaining '.($info_id3v2['padding']['length'] - $i).' bytes are considered invalid)');
   1.326 +                            break;
   1.327 +                        }
   1.328 +                    }
   1.329 +                    break; // skip rest of ID3v2 header
   1.330 +                }
   1.331 +
   1.332 +                if ($frame_name == 'COM ') {
   1.333 +                    $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably others too)]');
   1.334 +                    $frame_name = 'COMM';
   1.335 +                }
   1.336 +                if (($frame_size <= strlen($frame_data)) && (getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version))) {
   1.337 +
   1.338 +                    unset($parsed_frame);
   1.339 +                    $parsed_frame['frame_name']      = $frame_name;
   1.340 +                    $parsed_frame['frame_flags_raw'] = $frame_flags;
   1.341 +                    $parsed_frame['data']            = substr($frame_data, 0, $frame_size);
   1.342 +                    $parsed_frame['datalength']      = (int)($frame_size);
   1.343 +                    $parsed_frame['dataoffset']      = $frame_data_offset;
   1.344 +
   1.345 +                    $this->ParseID3v2Frame($parsed_frame);
   1.346 +                    $info_id3v2[$frame_name][] = $parsed_frame;
   1.347 +
   1.348 +                    $frame_data = substr($frame_data, $frame_size);
   1.349 +
   1.350 +                } else { // invalid frame length or FrameID
   1.351 +
   1.352 +                    if ($frame_size <= strlen($frame_data)) {
   1.353 +
   1.354 +                        if (getid3_id3v2::IsValidID3v2FrameName(substr($frame_data, $frame_size, 4), $id3v2_major_version)) {
   1.355 +
   1.356 +                            // next frame is valid, just skip the current frame
   1.357 +                            $frame_data = substr($frame_data, $frame_size);
   1.358 +                            $getid3->warning('Next ID3v2 frame is valid, skipping current frame.');
   1.359 +
   1.360 +                        } else {
   1.361 +
   1.362 +                            // next frame is invalid too, abort processing
   1.363 +                            throw new getid3_exception('Next ID3v2 frame is also invalid, aborting processing.');
   1.364 +
   1.365 +                        }
   1.366 +
   1.367 +                    } elseif ($frame_size == strlen($frame_data)) {
   1.368 +
   1.369 +                        // this is the last frame, just skip
   1.370 +                        $getid3->warning('This was the last ID3v2 frame.');
   1.371 +
   1.372 +                    } else {
   1.373 +
   1.374 +                        // next frame is invalid too, abort processing
   1.375 +                        $frame_data = null;
   1.376 +                        $getid3->warning('Invalid ID3v2 frame size, aborting.');
   1.377 +
   1.378 +                    }
   1.379 +                    if (!getid3_id3v2::IsValidID3v2FrameName($frame_name, $id3v2_major_version)) {
   1.380 +
   1.381 +                        switch ($frame_name) {
   1.382 +                            
   1.383 +                            case "\x00\x00".'MP':
   1.384 +                            case "\x00".'MP3':
   1.385 +                            case ' MP3':
   1.386 +                            case 'MP3e':
   1.387 +                            case "\x00".'MP':
   1.388 +                            case ' MP':
   1.389 +                            case 'MP3':
   1.390 +                                $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))). [Note: this particular error has been known to happen with tags edited by "MP3ext (www.mutschler.de/mp3ext/)"]');
   1.391 +                                break;
   1.392 +
   1.393 +                            default:
   1.394 +                                $getid3->warning('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: !IsValidID3v2FrameName("'.str_replace("\x00", ' ', $frame_name).'", '.$id3v2_major_version.'))).');
   1.395 +                                break;
   1.396 +                        }
   1.397 +
   1.398 +                    } elseif ($frame_size > strlen(@$frame_data)){
   1.399 +
   1.400 +                        throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag). (ERROR: $frame_size ('.$frame_size.') > strlen($frame_data) ('.strlen($frame_data).')).');
   1.401 +
   1.402 +                    } else {
   1.403 +
   1.404 +                        throw new getid3_exception('error parsing "'.$frame_name.'" ('.$frame_data_offset.' bytes into the ID3v2.'.$id3v2_major_version.' tag).');
   1.405 +
   1.406 +                    }
   1.407 +
   1.408 +                }
   1.409 +                $frame_data_offset += ($frame_size + ($id3v2_major_version == 2 ? 6 : 10));
   1.410 +
   1.411 +            }
   1.412 +
   1.413 +        }
   1.414 +
   1.415 +
   1.416 +        //    Footer
   1.417 +    
   1.418 +        //    The footer is a copy of the header, but with a different identifier.
   1.419 +        //        ID3v2 identifier           "3DI"
   1.420 +        //        ID3v2 version              $04 00
   1.421 +        //        ID3v2 flags                %abcd0000
   1.422 +        //        ID3v2 size             4 * %0xxxxxxx
   1.423 +
   1.424 +        if (isset($info_id3v2_flags['isfooter']) && $info_id3v2_flags['isfooter']) {
   1.425 +            $footer = fread ($getid3->fp, 10);
   1.426 +            if (substr($footer, 0, 3) == '3DI') {
   1.427 +                $info_id3v2['footer'] = true;
   1.428 +                $info_id3v2['majorversion_footer'] = ord($footer{3});
   1.429 +                $info_id3v2['minorversion_footer'] = ord($footer{4});
   1.430 +            }
   1.431 +            if ($info_id3v2['majorversion_footer'] <= 4) {
   1.432 +                $id3_flags = ord($footer{5});
   1.433 +                $info_id3v2_flags['unsynch_footer']  = (bool)($id3_flags & 0x80);
   1.434 +                $info_id3v2_flags['extfoot_footer']  = (bool)($id3_flags & 0x40);
   1.435 +                $info_id3v2_flags['experim_footer']  = (bool)($id3_flags & 0x20);
   1.436 +                $info_id3v2_flags['isfooter_footer'] = (bool)($id3_flags & 0x10);
   1.437 +
   1.438 +                $info_id3v2['footerlength'] = getid3_lib::BigEndianSyncSafe2Int(substr($footer, 6, 4));
   1.439 +            }
   1.440 +        } // end footer
   1.441 +
   1.442 +        if (isset($info_id3v2['comments']['genre'])) {
   1.443 +            foreach ($info_id3v2['comments']['genre'] as $key => $value) {
   1.444 +                unset($info_id3v2['comments']['genre'][$key]);
   1.445 +                $info_id3v2['comments'] = getid3_id3v2::array_merge_noclobber($info_id3v2['comments'], getid3_id3v2::ParseID3v2GenreString($value));
   1.446 +            }
   1.447 +        }
   1.448 +
   1.449 +        if (isset($info_id3v2['comments']['track'])) {
   1.450 +            foreach ($info_id3v2['comments']['track'] as $key => $value) {
   1.451 +                if (strstr($value, '/')) {
   1.452 +                    list($info_id3v2['comments']['track'][$key], $info_id3v2['comments']['totaltracks'][$key]) = explode('/', $info_id3v2['comments']['track'][$key]);
   1.453 +                }
   1.454 +            }
   1.455 +        }
   1.456 +        
   1.457 +        // Use year from recording time if year not set
   1.458 +        if (!isset($info_id3v2['comments']['year']) && ereg('^([0-9]{4})', @$info_id3v2['comments']['recording_time'][0], $matches)) {
   1.459 +			$info_id3v2['comments']['year'] = array ($matches[1]);
   1.460 +		}
   1.461 +
   1.462 +        // Set avdataoffset
   1.463 +        $getid3->info['avdataoffset'] = $info_id3v2['headerlength'];
   1.464 +        if (isset($info_id3v2['footer'])) {
   1.465 +            $getid3->info['avdataoffset'] += 10;
   1.466 +        }
   1.467 +
   1.468 +        return true;
   1.469 +    }
   1.470 +
   1.471 +
   1.472 +
   1.473 +    private function ParseID3v2Frame(&$parsed_frame) {
   1.474 +        
   1.475 +        $getid3 = $this->getid3;
   1.476 +
   1.477 +        $id3v2_major_version = $getid3->info['id3v2']['majorversion'];
   1.478 +
   1.479 +        $frame_name_long  = getid3_id3v2::FrameNameLongLookup($parsed_frame['frame_name']);
   1.480 +        if ($frame_name_long) {
   1.481 +            $parsed_frame['framenamelong']  = $frame_name_long; 
   1.482 +        }
   1.483 +        
   1.484 +        $frame_name_short = getid3_id3v2::FrameNameShortLookup($parsed_frame['frame_name']);
   1.485 +        if ($frame_name_short) {
   1.486 +            $parsed_frame['framenameshort']  = $frame_name_short; 
   1.487 +        }
   1.488 +
   1.489 +        if ($id3v2_major_version >= 3) { // frame flags are not part of the ID3v2.2 standard
   1.490 +
   1.491 +            if ($id3v2_major_version == 3) {
   1.492 +
   1.493 +                //    Frame Header Flags
   1.494 +                //    %abc00000 %ijk00000
   1.495 +
   1.496 +                $parsed_frame['flags']['TagAlterPreservation']  = (bool)($parsed_frame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation
   1.497 +                $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // b - File alter preservation
   1.498 +                $parsed_frame['flags']['ReadOnly']              = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // c - Read only
   1.499 +                $parsed_frame['flags']['compression']           = (bool)($parsed_frame['frame_flags_raw'] & 0x0080); // i - Compression
   1.500 +                $parsed_frame['flags']['Encryption']            = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // j - Encryption
   1.501 +                $parsed_frame['flags']['GroupingIdentity']      = (bool)($parsed_frame['frame_flags_raw'] & 0x0020); // k - Grouping identity
   1.502 +
   1.503 +
   1.504 +            } elseif ($id3v2_major_version == 4) {
   1.505 +
   1.506 +                //    Frame Header Flags
   1.507 +                //    %0abc0000 %0h00kmnp
   1.508 +
   1.509 +                $parsed_frame['flags']['TagAlterPreservation']  = (bool)($parsed_frame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation
   1.510 +                $parsed_frame['flags']['FileAlterPreservation'] = (bool)($parsed_frame['frame_flags_raw'] & 0x2000); // b - File alter preservation
   1.511 +                $parsed_frame['flags']['ReadOnly']              = (bool)($parsed_frame['frame_flags_raw'] & 0x1000); // c - Read only
   1.512 +                $parsed_frame['flags']['GroupingIdentity']      = (bool)($parsed_frame['frame_flags_raw'] & 0x0040); // h - Grouping identity
   1.513 +                $parsed_frame['flags']['compression']           = (bool)($parsed_frame['frame_flags_raw'] & 0x0008); // k - Compression
   1.514 +                $parsed_frame['flags']['Encryption']            = (bool)($parsed_frame['frame_flags_raw'] & 0x0004); // m - Encryption
   1.515 +                $parsed_frame['flags']['Unsynchronisation']     = (bool)($parsed_frame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation
   1.516 +                $parsed_frame['flags']['DataLengthIndicator']   = (bool)($parsed_frame['frame_flags_raw'] & 0x0001); // p - Data length indicator
   1.517 +
   1.518 +                // Frame-level de-unsynchronisation - ID3v2.4
   1.519 +                if ($parsed_frame['flags']['Unsynchronisation']) {
   1.520 +                    $parsed_frame['data'] = str_replace("\xFF\x00", "\xFF", $parsed_frame['data']);
   1.521 +                }
   1.522 +            }
   1.523 +
   1.524 +            //    Frame-level de-compression
   1.525 +            if ($parsed_frame['flags']['compression']) {
   1.526 +                $parsed_frame['decompressed_size'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 4));
   1.527 +                
   1.528 +                if (!function_exists('gzuncompress')) {
   1.529 +                    $getid3->warning('gzuncompress() support required to decompress ID3v2 frame "'.$parsed_frame['frame_name'].'"');
   1.530 +                } elseif ($decompressed_data = @gzuncompress(substr($parsed_frame['data'], 4))) {
   1.531 +                    $parsed_frame['data'] = $decompressed_data;
   1.532 +                } else {
   1.533 +                    $getid3->warning('gzuncompress() failed on compressed contents of ID3v2 frame "'.$parsed_frame['frame_name'].'"');
   1.534 +                }
   1.535 +            }
   1.536 +        }
   1.537 +
   1.538 +
   1.539 +        if (isset($parsed_frame['datalength']) && ($parsed_frame['datalength'] == 0)) {
   1.540 +
   1.541 +            $warning = 'Frame "'.$parsed_frame['frame_name'].'" at offset '.$parsed_frame['dataoffset'].' has no data portion';
   1.542 +            switch ($parsed_frame['frame_name']) {
   1.543 +                case 'WCOM':
   1.544 +                    $warning .= ' (this is known to happen with files tagged by RioPort)';
   1.545 +                    break;
   1.546 +
   1.547 +                default:
   1.548 +                    break;
   1.549 +            }
   1.550 +            $getid3->warning($warning);
   1.551 +            return true;
   1.552 +        }
   1.553 +        
   1.554 +        
   1.555 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'UFID')) ||   // 4.1   UFID Unique file identifier
   1.556 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'UFI'))) {    // 4.1   UFI  Unique file identifier
   1.557 +
   1.558 +            //   There may be more than one 'UFID' frame in a tag,
   1.559 +            //   but only one with the same 'Owner identifier'.
   1.560 +            // <Header for 'Unique file identifier', ID: 'UFID'>
   1.561 +            // Owner identifier        <text string> $00
   1.562 +            // Identifier              <up to 64 bytes binary data>
   1.563 +
   1.564 +            $frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
   1.565 +            $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
   1.566 +            $parsed_frame['ownerid'] = $frame_id_string;
   1.567 +            $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
   1.568 +            unset($parsed_frame['data']);
   1.569 +            return true;
   1.570 +        }
   1.571 +
   1.572 +
   1.573 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'TXXX')) ||   // 4.2.2 TXXX User defined text information frame
   1.574 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'TXX'))) {    // 4.2.2 TXX  User defined text information frame
   1.575 +
   1.576 +            //   There may be more than one 'TXXX' frame in each tag,
   1.577 +            //   but only one with the same description.
   1.578 +            // <Header for 'User defined text information frame', ID: 'TXXX'>
   1.579 +            // Text encoding     $xx
   1.580 +            // Description       <text string according to encoding> $00 (00)
   1.581 +            // Value             <text string according to encoding>
   1.582 +
   1.583 +            $frame_offset = 0;
   1.584 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.585 +
   1.586 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.587 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.588 +            }
   1.589 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
   1.590 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.591 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.592 +            }
   1.593 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
   1.594 +            if (ord($frame_description) === 0) {
   1.595 +                $frame_description = '';
   1.596 +            }
   1.597 +            $parsed_frame['encodingid']  = $frame_text_encoding;
   1.598 +            $parsed_frame['encoding']    = $this->TextEncodingNameLookup($frame_text_encoding);
   1.599 +
   1.600 +            $parsed_frame['description'] = $frame_description;
   1.601 +            $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
   1.602 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.603 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = trim($getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']));
   1.604 +            }
   1.605 +            unset($parsed_frame['data']);
   1.606 +            return true;
   1.607 +        }
   1.608 +        
   1.609 +
   1.610 +        if ($parsed_frame['frame_name']{0} == 'T') { // 4.2. T??[?] Text information frame
   1.611 +
   1.612 +            //   There may only be one text information frame of its kind in an tag.
   1.613 +            // <Header for 'Text information frame', ID: 'T000' - 'TZZZ',
   1.614 +            // excluding 'TXXX' described in 4.2.6.>
   1.615 +            // Text encoding                $xx
   1.616 +            // Information                  <text string(s) according to encoding>
   1.617 +
   1.618 +            $frame_offset = 0;
   1.619 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.620 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.621 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.622 +            }
   1.623 +
   1.624 +            $parsed_frame['data'] = (string)substr($parsed_frame['data'], $frame_offset);
   1.625 +
   1.626 +            $parsed_frame['encodingid'] = $frame_text_encoding;
   1.627 +            $parsed_frame['encoding']   = $this->TextEncodingNameLookup($frame_text_encoding);
   1.628 +
   1.629 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.630 +                
   1.631 +                // remove possible terminating \x00 (put by encoding id or software bug)
   1.632 +                $string = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
   1.633 +                if ($string[strlen($string)-1] = "\x00") {
   1.634 +                    $string = substr($string, 0, strlen($string)-1);
   1.635 +                }
   1.636 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $string;
   1.637 +                unset($string);
   1.638 +            }
   1.639 +            return true;
   1.640 +        }
   1.641 +
   1.642 +
   1.643 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'WXXX')) ||   // 4.3.2 WXXX User defined URL link frame
   1.644 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'WXX'))) {    // 4.3.2 WXX  User defined URL link frame
   1.645 +            
   1.646 +            //   There may be more than one 'WXXX' frame in each tag,
   1.647 +            //   but only one with the same description
   1.648 +            // <Header for 'User defined URL link frame', ID: 'WXXX'>
   1.649 +            // Text encoding     $xx
   1.650 +            // Description       <text string according to encoding> $00 (00)
   1.651 +            // URL               <text string>
   1.652 +
   1.653 +            $frame_offset = 0;
   1.654 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.655 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.656 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.657 +            }
   1.658 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
   1.659 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.660 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.661 +            }
   1.662 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
   1.663 +
   1.664 +            if (ord($frame_description) === 0) {
   1.665 +                $frame_description = '';
   1.666 +            }
   1.667 +            $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
   1.668 +
   1.669 +            $frame_terminator_pos = strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
   1.670 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.671 +                $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.672 +            }
   1.673 +            if ($frame_terminator_pos) {
   1.674 +                // there are null bytes after the data - this is not according to spec
   1.675 +                // only use data up to first null byte
   1.676 +                $frame_urldata = (string)substr($parsed_frame['data'], 0, $frame_terminator_pos);
   1.677 +            } else {
   1.678 +                // no null bytes following data, just use all data
   1.679 +                $frame_urldata = (string)$parsed_frame['data'];
   1.680 +            }
   1.681 +
   1.682 +            $parsed_frame['encodingid']  = $frame_text_encoding;
   1.683 +            $parsed_frame['encoding']    = $this->TextEncodingNameLookup($frame_text_encoding);
   1.684 +
   1.685 +            $parsed_frame['url']         = $frame_urldata;
   1.686 +            $parsed_frame['description'] = $frame_description;
   1.687 +            if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
   1.688 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['url']);
   1.689 +            }
   1.690 +            unset($parsed_frame['data']);
   1.691 +            return true;
   1.692 +        }
   1.693 +
   1.694 +
   1.695 +        if ($parsed_frame['frame_name']{0} == 'W') {        // 4.3. W??? URL link frames
   1.696 +
   1.697 +            //   There may only be one URL link frame of its kind in a tag,
   1.698 +            //   except when stated otherwise in the frame description
   1.699 +            // <Header for 'URL link frame', ID: 'W000' - 'WZZZ', excluding 'WXXX'
   1.700 +            // described in 4.3.2.>
   1.701 +            // URL              <text string>
   1.702 +
   1.703 +            $parsed_frame['url'] = trim($parsed_frame['data']);
   1.704 +            if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
   1.705 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['url'];
   1.706 +            }
   1.707 +            unset($parsed_frame['data']);
   1.708 +            return true;
   1.709 +        }
   1.710 +
   1.711 +
   1.712 +        if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'IPLS')) ||    // 4.4  IPLS Involved people list (ID3v2.3 only)
   1.713 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'IPL'))) {     // 4.4  IPL  Involved people list (ID3v2.2 only)
   1.714 +
   1.715 +            //   There may only be one 'IPL' frame in each tag
   1.716 +            // <Header for 'User defined URL link frame', ID: 'IPL'>
   1.717 +            // Text encoding     $xx
   1.718 +            // People list strings    <textstrings>
   1.719 +
   1.720 +            $frame_offset = 0;
   1.721 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.722 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.723 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.724 +            }
   1.725 +            $parsed_frame['encodingid'] = $frame_text_encoding;
   1.726 +            $parsed_frame['encoding']   = $this->TextEncodingNameLookup($parsed_frame['encodingid']);
   1.727 +
   1.728 +            $parsed_frame['data']       = (string)substr($parsed_frame['data'], $frame_offset);
   1.729 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.730 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
   1.731 +            }
   1.732 +            return true;
   1.733 +        }
   1.734 +
   1.735 +
   1.736 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MCDI')) ||    // 4.4   MCDI Music CD identifier
   1.737 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MCI'))) {     // 4.5   MCI  Music CD identifier
   1.738 +
   1.739 +            //   There may only be one 'MCDI' frame in each tag
   1.740 +            // <Header for 'Music CD identifier', ID: 'MCDI'>
   1.741 +            // CD TOC                <binary data>
   1.742 +
   1.743 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.744 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $parsed_frame['data'];
   1.745 +            }
   1.746 +            return true;
   1.747 +        }
   1.748 +
   1.749 +
   1.750 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ETCO')) ||    // 4.5   ETCO Event timing codes
   1.751 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ETC'))) {     // 4.6   ETC  Event timing codes
   1.752 +
   1.753 +            //   There may only be one 'ETCO' frame in each tag
   1.754 +            // <Header for 'Event timing codes', ID: 'ETCO'>
   1.755 +            // Time stamp format    $xx
   1.756 +            //   Where time stamp format is:
   1.757 +            // $01  (32-bit value) MPEG frames from beginning of file
   1.758 +            // $02  (32-bit value) milliseconds from beginning of file
   1.759 +            //   Followed by a list of key events in the following format:
   1.760 +            // Type of event   $xx
   1.761 +            // Time stamp      $xx (xx ...)
   1.762 +            //   The 'Time stamp' is set to zero if directly at the beginning of the sound
   1.763 +            //   or after the previous event. All events MUST be sorted in chronological order.
   1.764 +
   1.765 +            $frame_offset = 0;
   1.766 +            $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
   1.767 +
   1.768 +            while ($frame_offset < strlen($parsed_frame['data'])) {
   1.769 +                $parsed_frame['typeid']    = $parsed_frame['data']{$frame_offset++};
   1.770 +                $parsed_frame['type']      = getid3_id3v2::ETCOEventLookup($parsed_frame['typeid']);
   1.771 +                $parsed_frame['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
   1.772 +                $frame_offset += 4;
   1.773 +            }
   1.774 +            unset($parsed_frame['data']);
   1.775 +            return true;
   1.776 +        }
   1.777 +
   1.778 +
   1.779 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'MLLT')) ||     // 4.6   MLLT MPEG location lookup table
   1.780 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'MLL'))) {      // 4.7   MLL MPEG location lookup table
   1.781 +            
   1.782 +            //   There may only be one 'MLLT' frame in each tag
   1.783 +            // <Header for 'Location lookup table', ID: 'MLLT'>
   1.784 +            // MPEG frames between reference  $xx xx
   1.785 +            // Bytes between reference        $xx xx xx
   1.786 +            // Milliseconds between reference $xx xx xx
   1.787 +            // Bits for bytes deviation       $xx
   1.788 +            // Bits for milliseconds dev.     $xx
   1.789 +            //   Then for every reference the following data is included;
   1.790 +            // Deviation in bytes         %xxx....
   1.791 +            // Deviation in milliseconds  %xxx....
   1.792 +
   1.793 +            $frame_offset = 0;
   1.794 +            $parsed_frame['framesbetweenreferences'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 0, 2));
   1.795 +            $parsed_frame['bytesbetweenreferences']  = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 2, 3));
   1.796 +            $parsed_frame['msbetweenreferences']     = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], 5, 3));
   1.797 +            $parsed_frame['bitsforbytesdeviation']   = getid3_lib::BigEndian2Int($parsed_frame['data'][8]);
   1.798 +            $parsed_frame['bitsformsdeviation']      = getid3_lib::BigEndian2Int($parsed_frame['data'][9]);
   1.799 +            $parsed_frame['data'] = substr($parsed_frame['data'], 10);
   1.800 +            
   1.801 +            while ($frame_offset < strlen($parsed_frame['data'])) {
   1.802 +                $deviation_bitstream .= getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
   1.803 +            }
   1.804 +            $reference_counter = 0;
   1.805 +            while (strlen($deviation_bitstream) > 0) {
   1.806 +                $parsed_frame[$reference_counter]['bytedeviation'] = bindec(substr($deviation_bitstream, 0, $parsed_frame['bitsforbytesdeviation']));
   1.807 +                $parsed_frame[$reference_counter]['msdeviation']   = bindec(substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'], $parsed_frame['bitsformsdeviation']));
   1.808 +                $deviation_bitstream = substr($deviation_bitstream, $parsed_frame['bitsforbytesdeviation'] + $parsed_frame['bitsformsdeviation']);
   1.809 +                $reference_counter++;
   1.810 +            }
   1.811 +            unset($parsed_frame['data']);
   1.812 +            return true;
   1.813 +        }
   1.814 +
   1.815 +
   1.816 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYTC')) ||    // 4.7   SYTC Synchronised tempo codes
   1.817 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'STC'))) {     // 4.8   STC  Synchronised tempo codes
   1.818 +            
   1.819 +            //   There may only be one 'SYTC' frame in each tag
   1.820 +            // <Header for 'Synchronised tempo codes', ID: 'SYTC'>
   1.821 +            // Time stamp format   $xx
   1.822 +            // Tempo data          <binary data>
   1.823 +            //   Where time stamp format is:
   1.824 +            // $01  (32-bit value) MPEG frames from beginning of file
   1.825 +            // $02  (32-bit value) milliseconds from beginning of file
   1.826 +
   1.827 +            $frame_offset = 0;
   1.828 +            $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
   1.829 +            $timestamp_counter = 0;
   1.830 +            while ($frame_offset < strlen($parsed_frame['data'])) {
   1.831 +                $parsed_frame[$timestamp_counter]['tempo'] = ord($parsed_frame['data']{$frame_offset++});
   1.832 +                if ($parsed_frame[$timestamp_counter]['tempo'] == 255) {
   1.833 +                    $parsed_frame[$timestamp_counter]['tempo'] += ord($parsed_frame['data']{$frame_offset++});
   1.834 +                }
   1.835 +                $parsed_frame[$timestamp_counter]['timestamp'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
   1.836 +                $frame_offset += 4;
   1.837 +                $timestamp_counter++;
   1.838 +            }
   1.839 +            unset($parsed_frame['data']);
   1.840 +            return true;
   1.841 +        }
   1.842 +
   1.843 +  
   1.844 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USLT')) ||    // 4.8   USLT Unsynchronised lyric/text transcription
   1.845 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'ULT'))) {     // 4.9   ULT  Unsynchronised lyric/text transcription
   1.846 +            
   1.847 +            //   There may be more than one 'Unsynchronised lyrics/text transcription' frame
   1.848 +            //   in each tag, but only one with the same language and content descriptor.
   1.849 +            // <Header for 'Unsynchronised lyrics/text transcription', ID: 'USLT'>
   1.850 +            // Text encoding        $xx
   1.851 +            // Language             $xx xx xx
   1.852 +            // Content descriptor   <text string according to encoding> $00 (00)
   1.853 +            // Lyrics/text          <full text string according to encoding>
   1.854 +
   1.855 +            $frame_offset = 0;
   1.856 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.857 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.858 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.859 +            }
   1.860 +            $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
   1.861 +            $frame_offset += 3;
   1.862 +            if ($frame_offset > strlen($parsed_frame['data'])) {
   1.863 +                $frame_offset = strlen($parsed_frame['data']) - 1;
   1.864 +            }
   1.865 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
   1.866 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.867 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.868 +            }
   1.869 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
   1.870 +            if (ord($frame_description) === 0) {
   1.871 +                $frame_description = '';
   1.872 +            }
   1.873 +            $parsed_frame['data'] = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
   1.874 +
   1.875 +            $parsed_frame['encodingid']   = $frame_text_encoding;
   1.876 +            $parsed_frame['encoding']     = $this->TextEncodingNameLookup($frame_text_encoding);
   1.877 +
   1.878 +            $parsed_frame['data']         = $parsed_frame['data'];
   1.879 +            $parsed_frame['language']     = $frame_language;
   1.880 +            $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
   1.881 +            $parsed_frame['description']  = $frame_description;
   1.882 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.883 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
   1.884 +            }
   1.885 +            unset($parsed_frame['data']);
   1.886 +            return true;
   1.887 +        }
   1.888 +
   1.889 +
   1.890 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'SYLT')) ||    // 4.9   SYLT Synchronised lyric/text
   1.891 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'SLT'))) {     // 4.10  SLT  Synchronised lyric/text
   1.892 +            
   1.893 +            //   There may be more than one 'SYLT' frame in each tag,
   1.894 +            //   but only one with the same language and content descriptor.
   1.895 +            // <Header for 'Synchronised lyrics/text', ID: 'SYLT'>
   1.896 +            // Text encoding        $xx
   1.897 +            // Language             $xx xx xx
   1.898 +            // Time stamp format    $xx
   1.899 +            //   $01  (32-bit value) MPEG frames from beginning of file
   1.900 +            //   $02  (32-bit value) milliseconds from beginning of file
   1.901 +            // Content type         $xx
   1.902 +            // Content descriptor   <text string according to encoding> $00 (00)
   1.903 +            //   Terminated text to be synced (typically a syllable)
   1.904 +            //   Sync identifier (terminator to above string)   $00 (00)
   1.905 +            //   Time stamp                                     $xx (xx ...)
   1.906 +
   1.907 +            $frame_offset = 0;
   1.908 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.909 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.910 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.911 +            }
   1.912 +            $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
   1.913 +            $frame_offset += 3;
   1.914 +            $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
   1.915 +            $parsed_frame['contenttypeid']   = ord($parsed_frame['data']{$frame_offset++});
   1.916 +            $parsed_frame['contenttype']     = getid3_id3v2::SYTLContentTypeLookup($parsed_frame['contenttypeid']);
   1.917 +            $parsed_frame['encodingid']      = $frame_text_encoding;
   1.918 +            $parsed_frame['encoding']        = $this->TextEncodingNameLookup($frame_text_encoding);
   1.919 +
   1.920 +            $parsed_frame['language']        = $frame_language;
   1.921 +            $parsed_frame['languagename']    = getid3_id3v2::LanguageLookup($frame_language, false);
   1.922 +
   1.923 +            $timestamp_index = 0;
   1.924 +            $frame_remaining_data = substr($parsed_frame['data'], $frame_offset);
   1.925 +            while (strlen($frame_remaining_data)) {
   1.926 +                $frame_offset = 0;
   1.927 +                $frame_terminator_pos = strpos($frame_remaining_data, getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
   1.928 +                if ($frame_terminator_pos === false) {
   1.929 +                    $frame_remaining_data = '';
   1.930 +                } else {
   1.931 +                    if (ord(substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.932 +                        $frame_terminator_pos++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.933 +                    }
   1.934 +                    $parsed_frame['lyrics'][$timestamp_index]['data'] = substr($frame_remaining_data, $frame_offset, $frame_terminator_pos - $frame_offset);
   1.935 +
   1.936 +                    $frame_remaining_data = substr($frame_remaining_data, $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
   1.937 +                    if (($timestamp_index == 0) && (ord($frame_remaining_data{0}) != 0)) {
   1.938 +                        // timestamp probably omitted for first data item
   1.939 +                    } else {
   1.940 +                        $parsed_frame['lyrics'][$timestamp_index]['timestamp'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 4));
   1.941 +                        $frame_remaining_data = substr($frame_remaining_data, 4);
   1.942 +                    }
   1.943 +                    $timestamp_index++;
   1.944 +                }
   1.945 +            }
   1.946 +            unset($parsed_frame['data']);
   1.947 +            return true;
   1.948 +        }
   1.949 +
   1.950 +
   1.951 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMM')) ||    // 4.10  COMM Comments
   1.952 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'COM'))) {     // 4.11  COM  Comments
   1.953 +            
   1.954 +            //   There may be more than one comment frame in each tag,
   1.955 +            //   but only one with the same language and content descriptor.
   1.956 +            // <Header for 'Comment', ID: 'COMM'>
   1.957 +            // Text encoding          $xx
   1.958 +            // Language               $xx xx xx
   1.959 +            // Short content descrip. <text string according to encoding> $00 (00)
   1.960 +            // The actual text        <full text string according to encoding>
   1.961 +
   1.962 +            if (strlen($parsed_frame['data']) < 5) {
   1.963 +
   1.964 +                $getid3->warning('Invalid data (too short) for "'.$parsed_frame['frame_name'].'" frame at offset '.$parsed_frame['dataoffset']);
   1.965 +                return true;
   1.966 +            }
   1.967 +
   1.968 +            $frame_offset = 0;
   1.969 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
   1.970 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
   1.971 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
   1.972 +            }
   1.973 +            $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
   1.974 +            $frame_offset += 3;
   1.975 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
   1.976 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
   1.977 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
   1.978 +            }
   1.979 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
   1.980 +            if (ord($frame_description) === 0) {
   1.981 +                $frame_description = '';
   1.982 +            }
   1.983 +            $frame_text = (string)substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
   1.984 +
   1.985 +            $parsed_frame['encodingid']   = $frame_text_encoding;
   1.986 +            $parsed_frame['encoding']     = $this->TextEncodingNameLookup($frame_text_encoding);
   1.987 +
   1.988 +            $parsed_frame['language']     = $frame_language;
   1.989 +            $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
   1.990 +            $parsed_frame['description']  = $frame_description;
   1.991 +            $parsed_frame['data']         = $frame_text;
   1.992 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
   1.993 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
   1.994 +            }
   1.995 +            return true;
   1.996 +        }
   1.997 +            
   1.998 +
   1.999 +        if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'RVA2')) {   // 4.11  RVA2 Relative volume adjustment (2) (ID3v2.4+ only)
  1.1000 +            
  1.1001 +            //   There may be more than one 'RVA2' frame in each tag,
  1.1002 +            //   but only one with the same identification string
  1.1003 +            // <Header for 'Relative volume adjustment (2)', ID: 'RVA2'>
  1.1004 +            // Identification          <text string> $00
  1.1005 +            //   The 'identification' string is used to identify the situation and/or
  1.1006 +            //   device where this adjustment should apply. The following is then
  1.1007 +            //   repeated for every channel:
  1.1008 +            // Type of channel         $xx
  1.1009 +            // Volume adjustment       $xx xx
  1.1010 +            // Bits representing peak  $xx
  1.1011 +            // Peak volume             $xx (xx ...)
  1.1012 +
  1.1013 +            $frame_terminator_pos = strpos($parsed_frame['data'], "\x00");
  1.1014 +            $frame_id_string = substr($parsed_frame['data'], 0, $frame_terminator_pos);
  1.1015 +            if (ord($frame_id_string) === 0) {
  1.1016 +                $frame_id_string = '';
  1.1017 +            }
  1.1018 +            $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
  1.1019 +            $parsed_frame['description'] = $frame_id_string;
  1.1020 +            
  1.1021 +            while (strlen($frame_remaining_data)) {
  1.1022 +                $frame_offset = 0;
  1.1023 +                $frame_channeltypeid = ord(substr($frame_remaining_data, $frame_offset++, 1));
  1.1024 +                $parsed_frame[$frame_channeltypeid]['channeltypeid']  = $frame_channeltypeid;
  1.1025 +                $parsed_frame[$frame_channeltypeid]['channeltype']    = getid3_id3v2::RVA2ChannelTypeLookup($frame_channeltypeid);
  1.1026 +                $parsed_frame[$frame_channeltypeid]['volumeadjust']   = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, 2), true); // 16-bit signed
  1.1027 +                $frame_offset += 2;
  1.1028 +                $parsed_frame[$frame_channeltypeid]['bitspeakvolume'] = ord(substr($frame_remaining_data, $frame_offset++, 1));
  1.1029 +                $frame_bytespeakvolume = ceil($parsed_frame[$frame_channeltypeid]['bitspeakvolume'] / 8);
  1.1030 +                $parsed_frame[$frame_channeltypeid]['peakvolume']     = getid3_lib::BigEndian2Int(substr($frame_remaining_data, $frame_offset, $frame_bytespeakvolume));
  1.1031 +                $frame_remaining_data = substr($frame_remaining_data, $frame_offset + $frame_bytespeakvolume);
  1.1032 +            }
  1.1033 +            unset($parsed_frame['data']);
  1.1034 +            return true;
  1.1035 +        }
  1.1036 +        
  1.1037 +
  1.1038 +        if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'RVAD')) ||     // 4.12  RVAD Relative volume adjustment (ID3v2.3 only)
  1.1039 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'RVA'))) {      // 4.12  RVA  Relative volume adjustment (ID3v2.2 only)
  1.1040 +            
  1.1041 +            //   There may only be one 'RVA' frame in each tag
  1.1042 +            // <Header for 'Relative volume adjustment', ID: 'RVA'>
  1.1043 +            // ID3v2.2 => Increment/decrement     %000000ba
  1.1044 +            // ID3v2.3 => Increment/decrement     %00fedcba
  1.1045 +            // Bits used for volume descr.        $xx
  1.1046 +            // Relative volume change, right      $xx xx (xx ...) // a
  1.1047 +            // Relative volume change, left       $xx xx (xx ...) // b
  1.1048 +            // Peak volume right                  $xx xx (xx ...)
  1.1049 +            // Peak volume left                   $xx xx (xx ...)
  1.1050 +            //   ID3v2.3 only, optional (not present in ID3v2.2):
  1.1051 +            // Relative volume change, right back $xx xx (xx ...) // c
  1.1052 +            // Relative volume change, left back  $xx xx (xx ...) // d
  1.1053 +            // Peak volume right back             $xx xx (xx ...)
  1.1054 +            // Peak volume left back              $xx xx (xx ...)
  1.1055 +            //   ID3v2.3 only, optional (not present in ID3v2.2):
  1.1056 +            // Relative volume change, center     $xx xx (xx ...) // e
  1.1057 +            // Peak volume center                 $xx xx (xx ...)
  1.1058 +            //   ID3v2.3 only, optional (not present in ID3v2.2):
  1.1059 +            // Relative volume change, bass       $xx xx (xx ...) // f
  1.1060 +            // Peak volume bass                   $xx xx (xx ...)
  1.1061 +
  1.1062 +            $frame_offset = 0;
  1.1063 +            $frame_incrdecrflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
  1.1064 +            $parsed_frame['incdec']['right'] = (bool)substr($frame_incrdecrflags, 6, 1);
  1.1065 +            $parsed_frame['incdec']['left']  = (bool)substr($frame_incrdecrflags, 7, 1);
  1.1066 +            $parsed_frame['bitsvolume'] = ord($parsed_frame['data']{$frame_offset++});
  1.1067 +            $frame_bytesvolume = ceil($parsed_frame['bitsvolume'] / 8);
  1.1068 +            $parsed_frame['volumechange']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1069 +            if ($parsed_frame['incdec']['right'] === false) {
  1.1070 +                $parsed_frame['volumechange']['right'] *= -1;
  1.1071 +            }
  1.1072 +            $frame_offset += $frame_bytesvolume;
  1.1073 +            $parsed_frame['volumechange']['left'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1074 +            if ($parsed_frame['incdec']['left'] === false) {
  1.1075 +                $parsed_frame['volumechange']['left'] *= -1;
  1.1076 +            }
  1.1077 +            $frame_offset += $frame_bytesvolume;
  1.1078 +            $parsed_frame['peakvolume']['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1079 +            $frame_offset += $frame_bytesvolume;
  1.1080 +            $parsed_frame['peakvolume']['left']  = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1081 +            $frame_offset += $frame_bytesvolume;
  1.1082 +            if ($id3v2_major_version == 3) {
  1.1083 +                $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
  1.1084 +                if (strlen($parsed_frame['data']) > 0) {
  1.1085 +                    $parsed_frame['incdec']['rightrear'] = (bool)substr($frame_incrdecrflags, 4, 1);
  1.1086 +                    $parsed_frame['incdec']['leftrear']  = (bool)substr($frame_incrdecrflags, 5, 1);
  1.1087 +                    $parsed_frame['volumechange']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1088 +                    if ($parsed_frame['incdec']['rightrear'] === false) {
  1.1089 +                        $parsed_frame['volumechange']['rightrear'] *= -1;
  1.1090 +                    }
  1.1091 +                    $frame_offset += $frame_bytesvolume;
  1.1092 +                    $parsed_frame['volumechange']['leftrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1093 +                    if ($parsed_frame['incdec']['leftrear'] === false) {
  1.1094 +                        $parsed_frame['volumechange']['leftrear'] *= -1;
  1.1095 +                    }
  1.1096 +                    $frame_offset += $frame_bytesvolume;
  1.1097 +                    $parsed_frame['peakvolume']['rightrear'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1098 +                    $frame_offset += $frame_bytesvolume;
  1.1099 +                    $parsed_frame['peakvolume']['leftrear']  = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1100 +                    $frame_offset += $frame_bytesvolume;
  1.1101 +                }
  1.1102 +                $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
  1.1103 +                if (strlen($parsed_frame['data']) > 0) {
  1.1104 +                    $parsed_frame['incdec']['center'] = (bool)substr($frame_incrdecrflags, 3, 1);
  1.1105 +                    $parsed_frame['volumechange']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1106 +                    if ($parsed_frame['incdec']['center'] === false) {
  1.1107 +                        $parsed_frame['volumechange']['center'] *= -1;
  1.1108 +                    }
  1.1109 +                    $frame_offset += $frame_bytesvolume;
  1.1110 +                    $parsed_frame['peakvolume']['center'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1111 +                    $frame_offset += $frame_bytesvolume;
  1.1112 +                }
  1.1113 +                $parsed_frame['data'] = substr($parsed_frame['data'], $frame_offset);
  1.1114 +                if (strlen($parsed_frame['data']) > 0) {
  1.1115 +                    $parsed_frame['incdec']['bass'] = (bool)substr($frame_incrdecrflags, 2, 1);
  1.1116 +                    $parsed_frame['volumechange']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1117 +                    if ($parsed_frame['incdec']['bass'] === false) {
  1.1118 +                        $parsed_frame['volumechange']['bass'] *= -1;
  1.1119 +                    }
  1.1120 +                    $frame_offset += $frame_bytesvolume;
  1.1121 +                    $parsed_frame['peakvolume']['bass'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesvolume));
  1.1122 +                    $frame_offset += $frame_bytesvolume;
  1.1123 +                }
  1.1124 +            }
  1.1125 +            unset($parsed_frame['data']);
  1.1126 +            return true;
  1.1127 +        }
  1.1128 +
  1.1129 +
  1.1130 +        if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'EQU2')) { // 4.12  EQU2 Equalisation (2) (ID3v2.4+ only)
  1.1131 +            
  1.1132 +            //   There may be more than one 'EQU2' frame in each tag,
  1.1133 +            //   but only one with the same identification string
  1.1134 +            // <Header of 'Equalisation (2)', ID: 'EQU2'>
  1.1135 +            // Interpolation method  $xx
  1.1136 +            //   $00  Band
  1.1137 +            //   $01  Linear
  1.1138 +            // Identification        <text string> $00
  1.1139 +            //   The following is then repeated for every adjustment point
  1.1140 +            // Frequency          $xx xx
  1.1141 +            // Volume adjustment  $xx xx
  1.1142 +
  1.1143 +            $frame_offset = 0;
  1.1144 +            $frame_interpolationmethod = ord($parsed_frame['data']{$frame_offset++});
  1.1145 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1146 +            $frame_id_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1147 +            if (ord($frame_id_string) === 0) {
  1.1148 +                $frame_id_string = '';
  1.1149 +            }
  1.1150 +            $parsed_frame['description'] = $frame_id_string;
  1.1151 +            $frame_remaining_data = substr($parsed_frame['data'], $frame_terminator_pos + strlen("\x00"));
  1.1152 +            while (strlen($frame_remaining_data)) {
  1.1153 +                $frame_frequency = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 0, 2)) / 2;
  1.1154 +                $parsed_frame['data'][$frame_frequency] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, 2), true);
  1.1155 +                $frame_remaining_data = substr($frame_remaining_data, 4);
  1.1156 +            }
  1.1157 +            $parsed_frame['interpolationmethod'] = $frame_interpolationmethod;
  1.1158 +            unset($parsed_frame['data']);
  1.1159 +            return true;
  1.1160 +        }
  1.1161 +
  1.1162 +
  1.1163 +        if ((($id3v2_major_version == 3) && ($parsed_frame['frame_name'] == 'EQUA')) ||    // 4.12  EQUA Equalisation (ID3v2.3 only)
  1.1164 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'EQU'))) {     // 4.13  EQU  Equalisation (ID3v2.2 only)
  1.1165 +            
  1.1166 +            //   There may only be one 'EQUA' frame in each tag
  1.1167 +            // <Header for 'Relative volume adjustment', ID: 'EQU'>
  1.1168 +            // Adjustment bits    $xx
  1.1169 +            //   This is followed by 2 bytes + ('adjustment bits' rounded up to the
  1.1170 +            //   nearest byte) for every equalisation band in the following format,
  1.1171 +            //   giving a frequency range of 0 - 32767Hz:
  1.1172 +            // Increment/decrement   %x (MSB of the Frequency)
  1.1173 +            // Frequency             (lower 15 bits)
  1.1174 +            // Adjustment            $xx (xx ...)
  1.1175 +
  1.1176 +            $frame_offset = 0;
  1.1177 +            $parsed_frame['adjustmentbits'] = $parsed_frame['data']{$frame_offset++};
  1.1178 +            $frame_adjustment_bytes = ceil($parsed_frame['adjustmentbits'] / 8);
  1.1179 +
  1.1180 +            $frame_remaining_data = (string)substr($parsed_frame['data'], $frame_offset);
  1.1181 +            while (strlen($frame_remaining_data) > 0) {
  1.1182 +                $frame_frequencystr = getid3_lib::BigEndian2Bin(substr($frame_remaining_data, 0, 2));
  1.1183 +                $frame_incdec    = (bool)substr($frame_frequencystr, 0, 1);
  1.1184 +                $frame_frequency = bindec(substr($frame_frequencystr, 1, 15));
  1.1185 +                $parsed_frame[$frame_frequency]['incdec'] = $frame_incdec;
  1.1186 +                $parsed_frame[$frame_frequency]['adjustment'] = getid3_lib::BigEndian2Int(substr($frame_remaining_data, 2, $frame_adjustment_bytes));
  1.1187 +                if ($parsed_frame[$frame_frequency]['incdec'] === false) {
  1.1188 +                    $parsed_frame[$frame_frequency]['adjustment'] *= -1;
  1.1189 +                }
  1.1190 +                $frame_remaining_data = substr($frame_remaining_data, 2 + $frame_adjustment_bytes);
  1.1191 +            }
  1.1192 +            unset($parsed_frame['data']);
  1.1193 +            return true;
  1.1194 +        }
  1.1195 +
  1.1196 +
  1.1197 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RVRB')) ||    // 4.13  RVRB Reverb
  1.1198 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'REV'))) {     // 4.14  REV  Reverb
  1.1199 +            
  1.1200 +            //   There may only be one 'RVRB' frame in each tag.
  1.1201 +            // <Header for 'Reverb', ID: 'RVRB'>
  1.1202 +            // Reverb left (ms)                 $xx xx
  1.1203 +            // Reverb right (ms)                $xx xx
  1.1204 +            // Reverb bounces, left             $xx
  1.1205 +            // Reverb bounces, right            $xx
  1.1206 +            // Reverb feedback, left to left    $xx
  1.1207 +            // Reverb feedback, left to right   $xx
  1.1208 +            // Reverb feedback, right to right  $xx
  1.1209 +            // Reverb feedback, right to left   $xx
  1.1210 +            // Premix left to right             $xx
  1.1211 +            // Premix right to left             $xx
  1.1212 +
  1.1213 +            $frame_offset = 0;
  1.1214 +            $parsed_frame['left']  = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
  1.1215 +            $frame_offset += 2;
  1.1216 +            $parsed_frame['right'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
  1.1217 +            $frame_offset += 2;
  1.1218 +            $parsed_frame['bouncesL']   = ord($parsed_frame['data']{$frame_offset++});
  1.1219 +            $parsed_frame['bouncesR']   = ord($parsed_frame['data']{$frame_offset++});
  1.1220 +            $parsed_frame['feedbackLL'] = ord($parsed_frame['data']{$frame_offset++});
  1.1221 +            $parsed_frame['feedbackLR'] = ord($parsed_frame['data']{$frame_offset++});
  1.1222 +            $parsed_frame['feedbackRR'] = ord($parsed_frame['data']{$frame_offset++});
  1.1223 +            $parsed_frame['feedbackRL'] = ord($parsed_frame['data']{$frame_offset++});
  1.1224 +            $parsed_frame['premixLR']   = ord($parsed_frame['data']{$frame_offset++});
  1.1225 +            $parsed_frame['premixRL']   = ord($parsed_frame['data']{$frame_offset++});
  1.1226 +            unset($parsed_frame['data']);
  1.1227 +            return true;
  1.1228 +        }
  1.1229 +
  1.1230 +
  1.1231 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'APIC')) ||    // 4.14  APIC Attached picture
  1.1232 +           (($id3v2_major_version == 2)  && ($parsed_frame['frame_name'] == 'PIC'))) {     // 4.15  PIC  Attached picture
  1.1233 +
  1.1234 +            //   There may be several pictures attached to one file,
  1.1235 +            //   each in their individual 'APIC' frame, but only one
  1.1236 +            //   with the same content descriptor
  1.1237 +            // <Header for 'Attached picture', ID: 'APIC'>
  1.1238 +            // Text encoding      $xx
  1.1239 +            // ID3v2.3+ => MIME type          <text string> $00
  1.1240 +            // ID3v2.2  => Image format       $xx xx xx
  1.1241 +            // Picture type       $xx
  1.1242 +            // Description        <text string according to encoding> $00 (00)
  1.1243 +            // Picture data       <binary data>
  1.1244 +
  1.1245 +            $frame_offset = 0;
  1.1246 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
  1.1247 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
  1.1248 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
  1.1249 +            }
  1.1250 +
  1.1251 +            if ($id3v2_major_version == 2 && strlen($parsed_frame['data']) > $frame_offset) { 
  1.1252 +                $frame_imagetype = substr($parsed_frame['data'], $frame_offset, 3);
  1.1253 +                if (strtolower($frame_imagetype) == 'ima') {
  1.1254 +                    // complete hack for mp3Rage (www.chaoticsoftware.com) that puts ID3v2.3-formatted
  1.1255 +                    // MIME type instead of 3-char ID3v2.2-format image type  (thanks xbhoffØpacbell*net)
  1.1256 +                    $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1257 +                    $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1258 +                    if (ord($frame_mimetype) === 0) {
  1.1259 +                        $frame_mimetype = '';
  1.1260 +                    }
  1.1261 +                    $frame_imagetype = strtoupper(str_replace('image/', '', strtolower($frame_mimetype)));
  1.1262 +                    if ($frame_imagetype == 'JPEG') {
  1.1263 +                        $frame_imagetype = 'JPG';
  1.1264 +                    }
  1.1265 +                    $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1266 +                } else {
  1.1267 +                    $frame_offset += 3;
  1.1268 +                }
  1.1269 +            }
  1.1270 +            
  1.1271 +            if ($id3v2_major_version > 2 && strlen($parsed_frame['data']) > $frame_offset) {
  1.1272 +                $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1273 +                $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1274 +                if (ord($frame_mimetype) === 0) {
  1.1275 +                    $frame_mimetype = '';
  1.1276 +                }
  1.1277 +                $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1278 +            }
  1.1279 +
  1.1280 +            $frame_picturetype = ord($parsed_frame['data']{$frame_offset++});
  1.1281 +
  1.1282 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
  1.1283 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
  1.1284 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
  1.1285 +            }
  1.1286 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1287 +            if (ord($frame_description) === 0) {
  1.1288 +                $frame_description = '';
  1.1289 +            }
  1.1290 +            $parsed_frame['encodingid']       = $frame_text_encoding;
  1.1291 +            $parsed_frame['encoding']         = $this->TextEncodingNameLookup($frame_text_encoding);
  1.1292 +
  1.1293 +            if ($id3v2_major_version == 2) {
  1.1294 +                $parsed_frame['imagetype']    = $frame_imagetype;
  1.1295 +            } else {
  1.1296 +                $parsed_frame['mime']         = $frame_mimetype;
  1.1297 +            }
  1.1298 +            $parsed_frame['picturetypeid']    = $frame_picturetype;
  1.1299 +            $parsed_frame['picturetype']      = getid3_id3v2::APICPictureTypeLookup($frame_picturetype);
  1.1300 +            $parsed_frame['description']      = $frame_description;
  1.1301 +            $parsed_frame['data']             = substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)));
  1.1302 +
  1.1303 +            if ($getid3->option_tags_images) {
  1.1304 +                
  1.1305 +                $image_chunk_check = getid3_lib_image_size::get($parsed_frame['data']);
  1.1306 +                if (($image_chunk_check[2] >= 1) && ($image_chunk_check[2] <= 3)) {
  1.1307 +                    $parsed_frame['image_mime'] = image_type_to_mime_type($image_chunk_check[2]);
  1.1308 +                    
  1.1309 +                    if ($image_chunk_check[0]) {
  1.1310 +                        $parsed_frame['image_width']  = $image_chunk_check[0];
  1.1311 +                    }
  1.1312 +                    
  1.1313 +                    if ($image_chunk_check[1]) {
  1.1314 +                        $parsed_frame['image_height'] = $image_chunk_check[1];
  1.1315 +                    }
  1.1316 +                    
  1.1317 +                    $parsed_frame['image_bytes']      = strlen($parsed_frame['data']);
  1.1318 +                }
  1.1319 +            }
  1.1320 +
  1.1321 +            return true;
  1.1322 +        }
  1.1323 +
  1.1324 +
  1.1325 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GEOB')) ||    // 4.15  GEOB General encapsulated object
  1.1326 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'GEO'))) {     // 4.16  GEO  General encapsulated object
  1.1327 +            
  1.1328 +            //   There may be more than one 'GEOB' frame in each tag,
  1.1329 +            //   but only one with the same content descriptor
  1.1330 +            // <Header for 'General encapsulated object', ID: 'GEOB'>
  1.1331 +            // Text encoding          $xx
  1.1332 +            // MIME type              <text string> $00
  1.1333 +            // Filename               <text string according to encoding> $00 (00)
  1.1334 +            // Content description    <text string according to encoding> $00 (00)
  1.1335 +            // Encapsulated object    <binary data>
  1.1336 +
  1.1337 +            $frame_offset = 0;
  1.1338 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
  1.1339 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
  1.1340 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
  1.1341 +            }
  1.1342 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1343 +            $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1344 +            if (ord($frame_mimetype) === 0) {
  1.1345 +                $frame_mimetype = '';
  1.1346 +            }
  1.1347 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1348 +
  1.1349 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
  1.1350 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
  1.1351 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
  1.1352 +            }
  1.1353 +            $frame_filename = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1354 +            if (ord($frame_filename) === 0) {
  1.1355 +                $frame_filename = '';
  1.1356 +            }
  1.1357 +            $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
  1.1358 +
  1.1359 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
  1.1360 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
  1.1361 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
  1.1362 +            }
  1.1363 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1364 +            if (ord($frame_description) === 0) {
  1.1365 +                $frame_description = '';
  1.1366 +            }
  1.1367 +            $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
  1.1368 +
  1.1369 +            $parsed_frame['objectdata']  = (string)substr($parsed_frame['data'], $frame_offset);
  1.1370 +            $parsed_frame['encodingid']  = $frame_text_encoding;
  1.1371 +            $parsed_frame['encoding']    = $this->TextEncodingNameLookup($frame_text_encoding);
  1.1372 +
  1.1373 +            $parsed_frame['mime']        = $frame_mimetype;
  1.1374 +            $parsed_frame['filename']    = $frame_filename;
  1.1375 +            $parsed_frame['description'] = $frame_description;
  1.1376 +            unset($parsed_frame['data']);
  1.1377 +            return true;
  1.1378 +        }
  1.1379 +
  1.1380 +
  1.1381 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PCNT')) ||     // 4.16  PCNT Play counter
  1.1382 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CNT'))) {      // 4.17  CNT  Play counter
  1.1383 +            
  1.1384 +            //   There may only be one 'PCNT' frame in each tag.
  1.1385 +            //   When the counter reaches all one's, one byte is inserted in
  1.1386 +            //   front of the counter thus making the counter eight bits bigger
  1.1387 +            // <Header for 'Play counter', ID: 'PCNT'>
  1.1388 +            // Counter        $xx xx xx xx (xx ...)
  1.1389 +
  1.1390 +            $parsed_frame['data'] = getid3_lib::BigEndian2Int($parsed_frame['data']);
  1.1391 +            return true;
  1.1392 +        }
  1.1393 +
  1.1394 +
  1.1395 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POPM')) ||      // 4.17  POPM Popularimeter
  1.1396 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'POP'))) {       // 4.18  POP  Popularimeter
  1.1397 +            
  1.1398 +            //   There may be more than one 'POPM' frame in each tag,
  1.1399 +            //   but only one with the same email address
  1.1400 +            // <Header for 'Popularimeter', ID: 'POPM'>
  1.1401 +            // Email to user   <text string> $00
  1.1402 +            // Rating          $xx
  1.1403 +            // Counter         $xx xx xx xx (xx ...)
  1.1404 +
  1.1405 +            $frame_offset = 0;
  1.1406 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1407 +            $frame_email_address = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1408 +            if (ord($frame_email_address) === 0) {
  1.1409 +                $frame_email_address = '';
  1.1410 +            }
  1.1411 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1412 +            $frame_rating = ord($parsed_frame['data']{$frame_offset++});
  1.1413 +            $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
  1.1414 +            $parsed_frame['email']  = $frame_email_address;
  1.1415 +            $parsed_frame['rating'] = $frame_rating;
  1.1416 +            unset($parsed_frame['data']);
  1.1417 +            return true;
  1.1418 +        }
  1.1419 +
  1.1420 +
  1.1421 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RBUF')) ||     // 4.18  RBUF Recommended buffer size
  1.1422 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'BUF'))) {      // 4.19  BUF  Recommended buffer size
  1.1423 +            
  1.1424 +            //   There may only be one 'RBUF' frame in each tag
  1.1425 +            // <Header for 'Recommended buffer size', ID: 'RBUF'>
  1.1426 +            // Buffer size               $xx xx xx
  1.1427 +            // Embedded info flag        %0000000x
  1.1428 +            // Offset to next tag        $xx xx xx xx
  1.1429 +
  1.1430 +            $frame_offset = 0;
  1.1431 +            $parsed_frame['buffersize'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 3));
  1.1432 +            $frame_offset += 3;
  1.1433 +
  1.1434 +            $frame_embeddedinfoflags = getid3_lib::BigEndian2Bin($parsed_frame['data']{$frame_offset++});
  1.1435 +            $parsed_frame['flags']['embededinfo'] = (bool)substr($frame_embeddedinfoflags, 7, 1);
  1.1436 +            $parsed_frame['nexttagoffset'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
  1.1437 +            unset($parsed_frame['data']);
  1.1438 +            return true;
  1.1439 +        }
  1.1440 +
  1.1441 +
  1.1442 +        if (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRM')) { // 4.20  Encrypted meta frame (ID3v2.2 only)
  1.1443 +            
  1.1444 +            //   There may be more than one 'CRM' frame in a tag,
  1.1445 +            //   but only one with the same 'owner identifier'
  1.1446 +            // <Header for 'Encrypted meta frame', ID: 'CRM'>
  1.1447 +            // Owner identifier      <textstring> $00 (00)
  1.1448 +            // Content/explanation   <textstring> $00 (00)
  1.1449 +            // Encrypted datablock   <binary data>
  1.1450 +
  1.1451 +            $frame_offset = 0;
  1.1452 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1453 +            $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1454 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1455 +
  1.1456 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1457 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1458 +            if (ord($frame_description) === 0) {
  1.1459 +                $frame_description = '';
  1.1460 +            }
  1.1461 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1462 +
  1.1463 +            $parsed_frame['ownerid']     = $frame_owner_id;
  1.1464 +            $parsed_frame['data']        = (string)substr($parsed_frame['data'], $frame_offset);
  1.1465 +            $parsed_frame['description'] = $frame_description;
  1.1466 +            unset($parsed_frame['data']);
  1.1467 +            return true;
  1.1468 +        }
  1.1469 +
  1.1470 +
  1.1471 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'AENC')) ||      // 4.19  AENC Audio encryption
  1.1472 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'CRA'))) {       // 4.21  CRA  Audio encryption
  1.1473 +            
  1.1474 +            //   There may be more than one 'AENC' frames in a tag,
  1.1475 +            //   but only one with the same 'Owner identifier'
  1.1476 +            // <Header for 'Audio encryption', ID: 'AENC'>
  1.1477 +            // Owner identifier   <text string> $00
  1.1478 +            // Preview start      $xx xx
  1.1479 +            // Preview length     $xx xx
  1.1480 +            // Encryption info    <binary data>
  1.1481 +
  1.1482 +            $frame_offset = 0;
  1.1483 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1484 +            $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1485 +            if (ord($frame_owner_id) === 0) {
  1.1486 +                $frame_owner_id == '';
  1.1487 +            }
  1.1488 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1489 +            $parsed_frame['ownerid'] = $frame_owner_id;
  1.1490 +            $parsed_frame['previewstart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
  1.1491 +            $frame_offset += 2;
  1.1492 +            $parsed_frame['previewlength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
  1.1493 +            $frame_offset += 2;
  1.1494 +            $parsed_frame['encryptioninfo'] = (string)substr($parsed_frame['data'], $frame_offset);
  1.1495 +            unset($parsed_frame['data']);
  1.1496 +            return true;
  1.1497 +        }
  1.1498 +
  1.1499 +
  1.1500 +        if ((($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'LINK')) ||    // 4.20  LINK Linked information
  1.1501 +            (($id3v2_major_version == 2) && ($parsed_frame['frame_name'] == 'LNK'))) {     // 4.22  LNK  Linked information
  1.1502 +            
  1.1503 +            //   There may be more than one 'LINK' frame in a tag,
  1.1504 +            //   but only one with the same contents
  1.1505 +            // <Header for 'Linked information', ID: 'LINK'>
  1.1506 +            // ID3v2.3+ => Frame identifier   $xx xx xx xx
  1.1507 +            // ID3v2.2  => Frame identifier   $xx xx xx
  1.1508 +            // URL                            <text string> $00
  1.1509 +            // ID and additional data         <text string(s)>
  1.1510 +
  1.1511 +            $frame_offset = 0;
  1.1512 +            if ($id3v2_major_version == 2) {
  1.1513 +                $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 3);
  1.1514 +                $frame_offset += 3;
  1.1515 +            } else {
  1.1516 +                $parsed_frame['frameid'] = substr($parsed_frame['data'], $frame_offset, 4);
  1.1517 +                $frame_offset += 4;
  1.1518 +            }
  1.1519 +
  1.1520 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1521 +            $frame_url = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1522 +            if (ord($frame_url) === 0) {
  1.1523 +                $frame_url = '';
  1.1524 +            }
  1.1525 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1526 +            $parsed_frame['url'] = $frame_url;
  1.1527 +
  1.1528 +            $parsed_frame['additionaldata'] = (string)substr($parsed_frame['data'], $frame_offset);
  1.1529 +            if (!empty($parsed_frame['framenameshort']) && $parsed_frame['url']) {
  1.1530 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = utf8_encode($parsed_frame['url']);
  1.1531 +            }
  1.1532 +            unset($parsed_frame['data']);
  1.1533 +            return true;
  1.1534 +        }
  1.1535 +
  1.1536 +
  1.1537 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'POSS')) { // 4.21  POSS Position synchronisation frame (ID3v2.3+ only)
  1.1538 +            
  1.1539 +            //   There may only be one 'POSS' frame in each tag
  1.1540 +            // <Head for 'Position synchronisation', ID: 'POSS'>
  1.1541 +            // Time stamp format         $xx
  1.1542 +            // Position                  $xx (xx ...)
  1.1543 +
  1.1544 +            $frame_offset = 0;
  1.1545 +            $parsed_frame['timestampformat'] = ord($parsed_frame['data']{$frame_offset++});
  1.1546 +            $parsed_frame['position']        = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset));
  1.1547 +            unset($parsed_frame['data']);
  1.1548 +            return true;
  1.1549 +        }
  1.1550 +
  1.1551 +
  1.1552 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'USER')) { // 4.22  USER Terms of use (ID3v2.3+ only)
  1.1553 +            
  1.1554 +            //   There may be more than one 'Terms of use' frame in a tag,
  1.1555 +            //   but only one with the same 'Language'
  1.1556 +            // <Header for 'Terms of use frame', ID: 'USER'>
  1.1557 +            // Text encoding        $xx
  1.1558 +            // Language             $xx xx xx
  1.1559 +            // The actual text      <text string according to encoding>
  1.1560 +
  1.1561 +            $frame_offset = 0;
  1.1562 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
  1.1563 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
  1.1564 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
  1.1565 +            }
  1.1566 +            $frame_language = substr($parsed_frame['data'], $frame_offset, 3);
  1.1567 +            $frame_offset += 3;
  1.1568 +            $parsed_frame['language']     = $frame_language;
  1.1569 +            $parsed_frame['languagename'] = getid3_id3v2::LanguageLookup($frame_language, false);
  1.1570 +            $parsed_frame['encodingid']   = $frame_text_encoding;
  1.1571 +            $parsed_frame['encoding']     = $this->TextEncodingNameLookup($frame_text_encoding);
  1.1572 +
  1.1573 +            $parsed_frame['data']         = (string)substr($parsed_frame['data'], $frame_offset);
  1.1574 +            if (!empty($parsed_frame['framenameshort']) && !empty($parsed_frame['data'])) {
  1.1575 +                $getid3->info['id3v2']['comments'][$parsed_frame['framenameshort']][] = $getid3->iconv($parsed_frame['encoding'], 'UTF-8', $parsed_frame['data']);
  1.1576 +            }
  1.1577 +            unset($parsed_frame['data']);
  1.1578 +            return true;
  1.1579 +        }
  1.1580 +
  1.1581 +
  1.1582 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'OWNE')) { // 4.23  OWNE Ownership frame (ID3v2.3+ only)
  1.1583 +            
  1.1584 +            //   There may only be one 'OWNE' frame in a tag
  1.1585 +            // <Header for 'Ownership frame', ID: 'OWNE'>
  1.1586 +            // Text encoding     $xx
  1.1587 +            // Price paid        <text string> $00
  1.1588 +            // Date of purch.    <text string>
  1.1589 +            // Seller            <text string according to encoding>
  1.1590 +
  1.1591 +            $frame_offset = 0;
  1.1592 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
  1.1593 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
  1.1594 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
  1.1595 +            }
  1.1596 +            $parsed_frame['encodingid'] = $frame_text_encoding;
  1.1597 +            $parsed_frame['encoding']   = $this->TextEncodingNameLookup($frame_text_encoding);
  1.1598 +
  1.1599 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1600 +            $frame_pricepaid = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1601 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1602 +
  1.1603 +            $parsed_frame['pricepaid']['currencyid'] = substr($frame_pricepaid, 0, 3);
  1.1604 +            $parsed_frame['pricepaid']['currency']   = getid3_id3v2::LookupCurrencyUnits($parsed_frame['pricepaid']['currencyid']);
  1.1605 +            $parsed_frame['pricepaid']['value']      = substr($frame_pricepaid, 3);
  1.1606 +
  1.1607 +            $parsed_frame['purchasedate'] = substr($parsed_frame['data'], $frame_offset, 8);
  1.1608 +            if (!getid3_id3v2::IsValidDateStampString($parsed_frame['purchasedate'])) {
  1.1609 +                $parsed_frame['purchasedateunix'] = gmmktime (0, 0, 0, substr($parsed_frame['purchasedate'], 4, 2), substr($parsed_frame['purchasedate'], 6, 2), substr($parsed_frame['purchasedate'], 0, 4));
  1.1610 +            }
  1.1611 +            $frame_offset += 8;
  1.1612 +
  1.1613 +            $parsed_frame['seller'] = (string)substr($parsed_frame['data'], $frame_offset);
  1.1614 +            unset($parsed_frame['data']);
  1.1615 +            return true;
  1.1616 +        }
  1.1617 +
  1.1618 +
  1.1619 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'COMR')) { // 4.24  COMR Commercial frame (ID3v2.3+ only)
  1.1620 +            
  1.1621 +            //   There may be more than one 'commercial frame' in a tag,
  1.1622 +            //   but no two may be identical
  1.1623 +            // <Header for 'Commercial frame', ID: 'COMR'>
  1.1624 +            // Text encoding      $xx
  1.1625 +            // Price string       <text string> $00
  1.1626 +            // Valid until        <text string>
  1.1627 +            // Contact URL        <text string> $00
  1.1628 +            // Received as        $xx
  1.1629 +            // Name of seller     <text string according to encoding> $00 (00)
  1.1630 +            // Description        <text string according to encoding> $00 (00)
  1.1631 +            // Picture MIME type  <string> $00
  1.1632 +            // Seller logo        <binary data>
  1.1633 +
  1.1634 +            $frame_offset = 0;
  1.1635 +            $frame_text_encoding = ord($parsed_frame['data']{$frame_offset++});
  1.1636 +            if ((($id3v2_major_version <= 3) && ($frame_text_encoding > 1)) || (($id3v2_major_version == 4) && ($frame_text_encoding > 3))) {
  1.1637 +                $getid3->warning('Invalid text encoding byte ('.$frame_text_encoding.') in frame "'.$parsed_frame['frame_name'].'" - defaulting to ISO-8859-1 encoding');
  1.1638 +            }
  1.1639 +
  1.1640 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1641 +            $frame_price_string = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1642 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1643 +            $frame_rawpricearray = explode('/', $frame_price_string);
  1.1644 +            foreach ($frame_rawpricearray as $key => $val) {
  1.1645 +                $frame_currencyid = substr($val, 0, 3);
  1.1646 +                $parsed_frame['price'][$frame_currencyid]['currency'] = getid3_id3v2::LookupCurrencyUnits($frame_currencyid);
  1.1647 +                $parsed_frame['price'][$frame_currencyid]['value']    = substr($val, 3);
  1.1648 +            }
  1.1649 +
  1.1650 +            $frame_date_string = substr($parsed_frame['data'], $frame_offset, 8);
  1.1651 +            $frame_offset += 8;
  1.1652 +
  1.1653 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1654 +            $frame_contacturl = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1655 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1656 +
  1.1657 +            $frame_received_as_id = ord($parsed_frame['data']{$frame_offset++});
  1.1658 +
  1.1659 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
  1.1660 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
  1.1661 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
  1.1662 +            }
  1.1663 +            
  1.1664 +            $frame_sellername = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1665 +            if (ord($frame_sellername) === 0) {
  1.1666 +                $frame_sellername = '';
  1.1667 +            }
  1.1668 +            
  1.1669 +            $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
  1.1670 +
  1.1671 +            $frame_terminator_pos = @strpos($parsed_frame['data'], getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding), $frame_offset);
  1.1672 +            if (ord(substr($parsed_frame['data'], $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding)), 1)) === 0) {
  1.1673 +                $frame_terminator_pos++; // @strpos() fooled because 2nd byte of Unicode chars are often 0x00
  1.1674 +            }
  1.1675 +            
  1.1676 +            $frame_description = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1677 +            if (ord($frame_description) === 0) {
  1.1678 +                $frame_description = '';
  1.1679 +            }
  1.1680 +            
  1.1681 +            $frame_offset = $frame_terminator_pos + strlen(getid3_id3v2::TextEncodingTerminatorLookup($frame_text_encoding));
  1.1682 +
  1.1683 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1684 +            $frame_mimetype = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1685 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1686 +
  1.1687 +            $frame_sellerlogo = substr($parsed_frame['data'], $frame_offset);
  1.1688 +
  1.1689 +            $parsed_frame['encodingid']      = $frame_text_encoding;
  1.1690 +            $parsed_frame['encoding']        = $this->TextEncodingNameLookup($frame_text_encoding);
  1.1691 +
  1.1692 +            $parsed_frame['pricevaliduntil'] = $frame_date_string;
  1.1693 +            $parsed_frame['contacturl']      = $frame_contacturl;
  1.1694 +            $parsed_frame['receivedasid']    = $frame_received_as_id;
  1.1695 +            $parsed_frame['receivedas']      = getid3_id3v2::COMRReceivedAsLookup($frame_received_as_id);
  1.1696 +            $parsed_frame['sellername']      = $frame_sellername;
  1.1697 +            $parsed_frame['description']     = $frame_description;
  1.1698 +            $parsed_frame['mime']            = $frame_mimetype;
  1.1699 +            $parsed_frame['logo']            = $frame_sellerlogo;
  1.1700 +            unset($parsed_frame['data']);
  1.1701 +        }
  1.1702 +
  1.1703 +
  1.1704 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'ENCR')) { // 4.25  ENCR Encryption method registration (ID3v2.3+ only)
  1.1705 +            
  1.1706 +            //   There may be several 'ENCR' frames in a tag,
  1.1707 +            //   but only one containing the same symbol
  1.1708 +            //   and only one containing the same owner identifier
  1.1709 +            // <Header for 'Encryption method registration', ID: 'ENCR'>
  1.1710 +            // Owner identifier    <text string> $00
  1.1711 +            // Method symbol       $xx
  1.1712 +            // Encryption data     <binary data>
  1.1713 +
  1.1714 +            $frame_offset = 0;
  1.1715 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1716 +            $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1717 +            if (ord($frame_owner_id) === 0) {
  1.1718 +                $frame_owner_id = '';
  1.1719 +            }
  1.1720 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1721 +
  1.1722 +            $parsed_frame['ownerid']      = $frame_owner_id;
  1.1723 +            $parsed_frame['methodsymbol'] = ord($parsed_frame['data']{$frame_offset++});
  1.1724 +            $parsed_frame['data']         = (string)substr($parsed_frame['data'], $frame_offset);
  1.1725 +            return true;
  1.1726 +        }
  1.1727 +        
  1.1728 +
  1.1729 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'GRID')) { // 4.26  GRID Group identification registration (ID3v2.3+ only)
  1.1730 +
  1.1731 +            //   There may be several 'GRID' frames in a tag,
  1.1732 +            //   but only one containing the same symbol
  1.1733 +            //   and only one containing the same owner identifier
  1.1734 +            // <Header for 'Group ID registration', ID: 'GRID'>
  1.1735 +            // Owner identifier      <text string> $00
  1.1736 +            // Group symbol          $xx
  1.1737 +            // Group dependent data  <binary data>
  1.1738 +
  1.1739 +            $frame_offset = 0;
  1.1740 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1741 +            $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1742 +            if (ord($frame_owner_id) === 0) {
  1.1743 +                $frame_owner_id = '';
  1.1744 +            }
  1.1745 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1746 +
  1.1747 +            $parsed_frame['ownerid']       = $frame_owner_id;
  1.1748 +            $parsed_frame['groupsymbol']   = ord($parsed_frame['data']{$frame_offset++});
  1.1749 +            $parsed_frame['data']          = (string)substr($parsed_frame['data'], $frame_offset);
  1.1750 +            return true;
  1.1751 +        }
  1.1752 +
  1.1753 +
  1.1754 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'PRIV')) { // 4.27  PRIV Private frame (ID3v2.3+ only)
  1.1755 +            
  1.1756 +            //   The tag may contain more than one 'PRIV' frame
  1.1757 +            //   but only with different contents
  1.1758 +            // <Header for 'Private frame', ID: 'PRIV'>
  1.1759 +            // Owner identifier      <text string> $00
  1.1760 +            // The private data      <binary data>
  1.1761 +
  1.1762 +            $frame_offset = 0;
  1.1763 +            $frame_terminator_pos = @strpos($parsed_frame['data'], "\x00", $frame_offset);
  1.1764 +            $frame_owner_id = substr($parsed_frame['data'], $frame_offset, $frame_terminator_pos - $frame_offset);
  1.1765 +            if (ord($frame_owner_id) === 0) {
  1.1766 +                $frame_owner_id = '';
  1.1767 +            }
  1.1768 +            $frame_offset = $frame_terminator_pos + strlen("\x00");
  1.1769 +
  1.1770 +            $parsed_frame['ownerid'] = $frame_owner_id;
  1.1771 +            $parsed_frame['data']    = (string)substr($parsed_frame['data'], $frame_offset);
  1.1772 +            return true;
  1.1773 +        }
  1.1774 +
  1.1775 +
  1.1776 +        if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SIGN')) { // 4.28  SIGN Signature frame (ID3v2.4+ only)
  1.1777 +            
  1.1778 +            //   There may be more than one 'signature frame' in a tag,
  1.1779 +            //   but no two may be identical
  1.1780 +            // <Header for 'Signature frame', ID: 'SIGN'>
  1.1781 +            // Group symbol      $xx
  1.1782 +            // Signature         <binary data>
  1.1783 +
  1.1784 +            $frame_offset = 0;
  1.1785 +            $parsed_frame['groupsymbol'] = ord($parsed_frame['data']{$frame_offset++});
  1.1786 +            $parsed_frame['data']        = (string)substr($parsed_frame['data'], $frame_offset);
  1.1787 +            return true;
  1.1788 +        }
  1.1789 +
  1.1790 +
  1.1791 +        if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'SEEK')) { // 4.29  SEEK Seek frame (ID3v2.4+ only)
  1.1792 +            
  1.1793 +            //   There may only be one 'seek frame' in a tag
  1.1794 +            // <Header for 'Seek frame', ID: 'SEEK'>
  1.1795 +            // Minimum offset to next tag       $xx xx xx xx
  1.1796 +
  1.1797 +            $frame_offset = 0;
  1.1798 +            $parsed_frame['data'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
  1.1799 +            return true;
  1.1800 +        }
  1.1801 +
  1.1802 +
  1.1803 +        if (($id3v2_major_version >= 4) && ($parsed_frame['frame_name'] == 'ASPI')) { // 4.30  ASPI Audio seek point index (ID3v2.4+ only)
  1.1804 +            
  1.1805 +            //   There may only be one 'audio seek point index' frame in a tag
  1.1806 +            // <Header for 'Seek Point Index', ID: 'ASPI'>
  1.1807 +            // Indexed data start (S)         $xx xx xx xx
  1.1808 +            // Indexed data length (L)        $xx xx xx xx
  1.1809 +            // Number of index points (N)     $xx xx
  1.1810 +            // Bits per index point (b)       $xx
  1.1811 +            //   Then for every index point the following data is included:
  1.1812 +            // Fraction at index (Fi)          $xx (xx)
  1.1813 +
  1.1814 +            $frame_offset = 0;
  1.1815 +            $parsed_frame['datastart'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
  1.1816 +            $frame_offset += 4;
  1.1817 +            $parsed_frame['indexeddatalength'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
  1.1818 +            $frame_offset += 4;
  1.1819 +            $parsed_frame['indexpoints'] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 2));
  1.1820 +            $frame_offset += 2;
  1.1821 +            $parsed_frame['bitsperpoint'] = ord($parsed_frame['data']{$frame_offset++});
  1.1822 +            $frame_bytesperpoint = ceil($parsed_frame['bitsperpoint'] / 8);
  1.1823 +            for ($i = 0; $i < $frame_indexpoints; $i++) {
  1.1824 +                $parsed_frame['indexes'][$i] = getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, $frame_bytesperpoint));
  1.1825 +                $frame_offset += $frame_bytesperpoint;
  1.1826 +            }
  1.1827 +            unset($parsed_frame['data']);
  1.1828 +            return true;
  1.1829 +        }
  1.1830 +
  1.1831 +
  1.1832 +        if (($id3v2_major_version >= 3) && ($parsed_frame['frame_name'] == 'RGAD')) { // Replay Gain Adjustment
  1.1833 +
  1.1834 +            // http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
  1.1835 +            //   There may only be one 'RGAD' frame in a tag
  1.1836 +            // <Header for 'Replay Gain Adjustment', ID: 'RGAD'>
  1.1837 +            // Peak Amplitude                      $xx $xx $xx $xx
  1.1838 +            // Radio Replay Gain Adjustment        %aaabbbcd %dddddddd
  1.1839 +            // Audiophile Replay Gain Adjustment   %aaabbbcd %dddddddd
  1.1840 +            //   a - name code
  1.1841 +            //   b - originator code
  1.1842 +            //   c - sign bit
  1.1843 +            //   d - replay gain adjustment
  1.1844 +
  1.1845 +            $frame_offset = 0;
  1.1846 +            
  1.1847 +            $parsed_frame['peakamplitude'] = (float)getid3_lib::BigEndian2Int(substr($parsed_frame['data'], $frame_offset, 4));
  1.1848 +            $frame_offset += 4;
  1.1849 +            
  1.1850 +            $rg_track_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
  1.1851 +            $frame_offset += 2;
  1.1852 +            
  1.1853 +            $rg_album_adjustment = decbin(substr($parsed_frame['data'], $frame_offset, 2));
  1.1854 +            $frame_offset += 2;
  1.1855 +            
  1.1856 +            $parsed_frame['raw']['track']['name']       = bindec(substr($rg_track_adjustment, 0, 3));
  1.1857 +            $parsed_frame['raw']['track']['originator'] = bindec(substr($rg_track_adjustment, 3, 3));
  1.1858 +            $parsed_frame['raw']['track']['signbit']    = bindec($rg_track_adjustment[6]);
  1.1859 +            $parsed_frame['raw']['track']['adjustment'] = bindec(substr($rg_track_adjustment, 7, 9));
  1.1860 +            $parsed_frame['raw']['album']['name']       = bindec(substr($rg_album_adjustment, 0, 3));
  1.1861 +            $parsed_frame['raw']['album']['originator'] = bindec(substr($rg_album_adjustment, 3, 3));
  1.1862 +            $parsed_frame['raw']['album']['signbit']    = bindec($rg_album_adjustment[6]);
  1.1863 +            $parsed_frame['raw']['album']['adjustment'] = bindec(substr($rg_album_adjustment, 7, 9));
  1.1864 +            $parsed_frame['track']['name']              = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['track']['name']);
  1.1865 +            $parsed_frame['track']['originator']        = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['track']['originator']);
  1.1866 +            $parsed_frame['track']['adjustment']        = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['track']['adjustment'], $parsed_frame['raw']['track']['signbit']);
  1.1867 +            $parsed_frame['album']['name']              = getid3_lib_replaygain::NameLookup($parsed_frame['raw']['album']['name']);
  1.1868 +            $parsed_frame['album']['originator']        = getid3_lib_replaygain::OriginatorLookup($parsed_frame['raw']['album']['originator']);
  1.1869 +            $parsed_frame['album']['adjustment']        = getid3_lib_replaygain::AdjustmentLookup($parsed_frame['raw']['album']['adjustment'], $parsed_frame['raw']['album']['signbit']);
  1.1870 +
  1.1871 +            $getid3->info['replay_gain']['track']['peak']       = $parsed_frame['peakamplitude'];
  1.1872 +            $getid3->info['replay_gain']['track']['originator'] = $parsed_frame['track']['originator'];
  1.1873 +            $getid3->info['replay_gain']['track']['adjustment'] = $parsed_frame['track']['adjustment'];
  1.1874 +            $getid3->info['replay_gain']['album']['originator'] = $parsed_frame['album']['originator'];
  1.1875 +            $getid3->info['replay_gain']['album']['adjustment'] = $parsed_frame['album']['adjustment'];
  1.1876 +
  1.1877 +            unset($parsed_frame['data']);
  1.1878 +            return true;
  1.1879 +        }
  1.1880 +
  1.1881 +        return true;
  1.1882 +    }
  1.1883 +    
  1.1884 +    
  1.1885 +    
  1.1886 +    private function TextEncodingNameLookup($encoding) {
  1.1887 +        
  1.1888 +        // Override specification - BRAINDEAD taggers
  1.1889 +        if (!$encoding) {
  1.1890 +            return $this->getid3->encoding_id3v2;
  1.1891 +        }
  1.1892 +           
  1.1893 +        // http://www.id3.org/id3v2.4.0-structure.txt
  1.1894 +        static $lookup = array (
  1.1895 +            0   => 'ISO-8859-1', 
  1.1896 +            1   => 'UTF-16', 
  1.1897 +            2   => 'UTF-16BE', 
  1.1898 +            3   => 'UTF-8', 
  1.1899 +            255 => 'UTF-16BE'
  1.1900 +        );
  1.1901 +        
  1.1902 +        return (isset($lookup[$encoding]) ? $lookup[$encoding] : 'ISO-8859-1');
  1.1903 +    }
  1.1904 +
  1.1905 +
  1.1906 +
  1.1907 +    public static function ParseID3v2GenreString($genre_string) {
  1.1908 +        
  1.1909 +        // Parse genres into arrays of genreName and genreID
  1.1910 +        // ID3v2.2.x, ID3v2.3.x: '(21)' or '(4)Eurodisco' or '(51)(39)' or '(55)((I think...)'
  1.1911 +        // ID3v2.4.x: '21' $00 'Eurodisco' $00
  1.1912 +
  1.1913 +        $genre_string = trim($genre_string);
  1.1914 +        $return_array = array ();
  1.1915 +        if (strpos($genre_string, "\x00") !== false) {
  1.1916 +            $unprocessed = trim($genre_string); // trailing nulls will cause an infinite loop.
  1.1917 +            $genre_string = '';
  1.1918 +            while (strpos($unprocessed, "\x00") !== false) {
  1.1919 +                // convert null-seperated v2.4-format into v2.3 ()-seperated format
  1.1920 +                $end_pos = strpos($unprocessed, "\x00");
  1.1921 +                $genre_string .= '('.substr($unprocessed, 0, $end_pos).')';
  1.1922 +                $unprocessed = substr($unprocessed, $end_pos + 1);
  1.1923 +            }
  1.1924 +            unset($unprocessed);
  1.1925 +        }
  1.1926 +        if (getid3_id3v1::LookupGenreID($genre_string)) {
  1.1927 +
  1.1928 +            $return_array['genre'][] = $genre_string;
  1.1929 +
  1.1930 +        } else {
  1.1931 +
  1.1932 +            while (strpos($genre_string, '(') !== false) {
  1.1933 +
  1.1934 +                $start_pos = strpos($genre_string, '(');
  1.1935 +                $end_pos   = strpos($genre_string, ')');
  1.1936 +                if (substr($genre_string, $start_pos + 1, 1) == '(') {
  1.1937 +                    $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $start_pos + 1);
  1.1938 +                    $end_pos--;
  1.1939 +                }
  1.1940 +                $element      = substr($genre_string, $start_pos + 1, $end_pos - ($start_pos + 1));
  1.1941 +                $genre_string = substr($genre_string, 0, $start_pos).substr($genre_string, $end_pos + 1);
  1.1942 +                
  1.1943 +                if (getid3_id3v1::LookupGenreName($element)) { // $element is a valid genre id/abbreviation
  1.1944 +
  1.1945 +                    if (empty($return_array['genre']) || !in_array(getid3_id3v1::LookupGenreName($element), $return_array['genre'])) { // avoid duplicate entires
  1.1946 +                        $return_array['genre'][] = getid3_id3v1::LookupGenreName($element);
  1.1947 +                    }
  1.1948 +                } else {
  1.1949 +
  1.1950 +                    if (empty($return_array['genre']) || !in_array($element, $return_array['genre'])) { // avoid duplicate entires
  1.1951 +                        $return_array['genre'][] = $element;
  1.1952 +                    }
  1.1953 +                }
  1.1954 +            }
  1.1955 +        }
  1.1956 +        if ($genre_string) {
  1.1957 +            if (empty($return_array['genre']) || !in_array($genre_string, $return_array['genre'])) { // avoid duplicate entires
  1.1958 +                $return_array['genre'][] = $genre_string;
  1.1959 +            }
  1.1960 +        }
  1.1961 +
  1.1962 +        return $return_array;
  1.1963 +    }
  1.1964 +    
  1.1965 +    
  1.1966 +    
  1.1967 +    public static function LookupCurrencyUnits($currency_id) {
  1.1968 +
  1.1969 +        static $lookup = array (
  1.1970 +            'AED' => 'Dirhams',
  1.1971 +            'AFA' => 'Afghanis',
  1.1972 +            'ALL' => 'Leke',
  1.1973 +            'AMD' => 'Drams',
  1.1974 +            'ANG' => 'Guilders',
  1.1975 +            'AOA' => 'Kwanza',
  1.1976 +            'ARS' => 'Pesos',
  1.1977 +            'ATS' => 'Schillings',
  1.1978 +            'AUD' => 'Dollars',
  1.1979 +            'AWG' => 'Guilders',
  1.1980 +            'AZM' => 'Manats',
  1.1981 +            'BAM' => 'Convertible Marka',
  1.1982 +            'BBD' => 'Dollars',
  1.1983 +            'BDT' => 'Taka',
  1.1984 +            'BEF' => 'Francs',
  1.1985 +            'BGL' => 'Leva',
  1.1986 +            'BHD' => 'Dinars',
  1.1987 +            'BIF' => 'Francs',
  1.1988 +            'BMD' => 'Dollars',
  1.1989 +            'BND' => 'Dollars',
  1.1990 +            'BOB' => 'Bolivianos',
  1.1991 +            'BRL' => 'Brazil Real',
  1.1992 +            'BSD' => 'Dollars',
  1.1993 +            'BTN' => 'Ngultrum',
  1.1994 +            'BWP' => 'Pulas',
  1.1995 +            'BYR' => 'Rubles',
  1.1996 +            'BZD' => 'Dollars',
  1.1997 +            'CAD' => 'Dollars',
  1.1998 +            'CDF' => 'Congolese Francs',
  1.1999 +            'CHF' => 'Francs',
  1.2000 +            'CLP' => 'Pesos',
  1.2001 +            'CNY' => 'Yuan Renminbi',
  1.2002 +            'COP' => 'Pesos',
  1.2003 +            'CRC' => 'Colones',
  1.2004 +            'CUP' => 'Pesos',
  1.2005 +            'CVE' => 'Escudos',
  1.2006 +            'CYP' => 'Pounds',
  1.2007 +            'CZK' => 'Koruny',
  1.2008 +            'DEM' => 'Deutsche Marks',
  1.2009 +            'DJF' => 'Francs',
  1.2010 +            'DKK' => 'Kroner',
  1.2011 +            'DOP' => 'Pesos',
  1.2012 +            'DZD' => 'Algeria Dinars',
  1.2013 +            'EEK' => 'Krooni',
  1.2014 +            'EGP' => 'Pounds',
  1.2015 +            'ERN' => 'Nakfa',
  1.2016 +            'ESP' => 'Pesetas',
  1.2017 +            'ETB' => 'Birr',
  1.2018 +            'EUR' => 'Euro',
  1.2019 +            'FIM' => 'Markkaa',
  1.2020 +            'FJD' => 'Dollars',
  1.2021 +            'FKP' => 'Pounds',
  1.2022 +            'FRF' => 'Francs',
  1.2023 +            'GBP' => 'Pounds',
  1.2024 +            'GEL' => 'Lari',
  1.2025 +            'GGP' => 'Pounds',
  1.2026 +            'GHC' => 'Cedis',
  1.2027 +            'GIP' => 'Pounds',
  1.2028 +            'GMD' => 'Dalasi',
  1.2029 +            'GNF' => 'Francs',
  1.2030 +            'GRD' => 'Drachmae',
  1.2031 +            'GTQ' => 'Quetzales',
  1.2032 +            'GYD' => 'Dollars',
  1.2033 +            'HKD' => 'Dollars',
  1.2034 +            'HNL' => 'Lempiras',
  1.2035 +            'HRK' => 'Kuna',
  1.2036 +            'HTG' => 'Gourdes',
  1.2037 +            'HUF' => 'Forints',
  1.2038 +            'IDR' => 'Rupiahs',
  1.2039 +            'IEP' => 'Pounds',
  1.2040 +            'ILS' => 'New Shekels',
  1.2041 +            'IMP' => 'Pounds',
  1.2042 +            'INR' => 'Rupees',
  1.2043 +            'IQD' => 'Dinars',
  1.2044 +            'IRR' => 'Rials',
  1.2045 +            'ISK' => 'Kronur',
  1.2046 +            'ITL' => 'Lire',
  1.2047 +            'JEP' => 'Pounds',
  1.2048 +            'JMD' => 'Dollars',
  1.2049 +            'JOD' => 'Dinars',
  1.2050 +            'JPY' => 'Yen',
  1.2051 +            'KES' => 'Shillings',
  1.2052 +            'KGS' => 'Soms',
  1.2053 +            'KHR' => 'Riels',
  1.2054 +            'KMF' => 'Francs',
  1.2055 +            'KPW' => 'Won',
  1.2056 +            'KWD' => 'Dinars',
  1.2057 +            'KYD' => 'Dollars',
  1.2058 +            'KZT' => 'Tenge',
  1.2059 +            'LAK' => 'Kips',
  1.2060 +            'LBP' => 'Pounds',
  1.2061 +            'LKR' => 'Rupees',
  1.2062 +            'LRD' => 'Dollars',
  1.2063 +            'LSL' => 'Maloti',
  1.2064 +            'LTL' => 'Litai',
  1.2065 +            'LUF' => 'Francs',
  1.2066 +            'LVL' => 'Lati',
  1.2067 +            'LYD' => 'Dinars',
  1.2068 +            'MAD' => 'Dirhams',
  1.2069 +            'MDL' => 'Lei',
  1.2070 +            'MGF' => 'Malagasy Francs',
  1.2071 +            'MKD' => 'Denars',
  1.2072 +            'MMK' => 'Kyats',
  1.2073 +            'MNT' => 'Tugriks',
  1.2074 +            'MOP' => 'Patacas',
  1.2075 +            'MRO' => 'Ouguiyas',
  1.2076 +            'MTL' => 'Liri',
  1.2077 +            'MUR' => 'Rupees',
  1.2078 +            'MVR' => 'Rufiyaa',
  1.2079 +            'MWK' => 'Kwachas',
  1.2080 +            'MXN' => 'Pesos',
  1.2081 +            'MYR' => 'Ringgits',
  1.2082 +            'MZM' => 'Meticais',
  1.2083 +            'NAD' => 'Dollars',
  1.2084 +            'NGN' => 'Nairas',
  1.2085 +            'NIO' => 'Gold Cordobas',
  1.2086 +            'NLG' => 'Guilders',
  1.2087 +            'NOK' => 'Krone',
  1.2088 +            'NPR' => 'Nepal Rupees',
  1.2089 +            'NZD' => 'Dollars',
  1.2090 +            'OMR' => 'Rials',
  1.2091 +            'PAB' => 'Balboa',
  1.2092 +            'PEN' => 'Nuevos Soles',
  1.2093 +            'PGK' => 'Kina',
  1.2094 +            'PHP' => 'Pesos',
  1.2095 +            'PKR' => 'Rupees',
  1.2096 +            'PLN' => 'Zlotych',
  1.2097 +            'PTE' => 'Escudos',
  1.2098 +            'PYG' => 'Guarani',
  1.2099 +            'QAR' => 'Rials',
  1.2100 +            'ROL' => 'Lei',
  1.2101 +            'RUR' => 'Rubles',
  1.2102 +            'RWF' => 'Rwanda Francs',
  1.2103 +            'SAR' => 'Riyals',
  1.2104 +            'SBD' => 'Dollars',
  1.2105 +            'SCR' => 'Rupees',
  1.2106 +            'SDD' => 'Dinars',
  1.2107 +            'SEK' => 'Kronor',
  1.2108 +            'SGD' => 'Dollars',
  1.2109 +            'SHP' => 'Pounds',
  1.2110 +            'SIT' => 'Tolars',
  1.2111 +            'SKK' => 'Koruny',
  1.2112 +            'SLL' => 'Leones',
  1.2113 +            'SOS' => 'Shillings',
  1.2114 +            'SPL' => 'Luigini',
  1.2115 +            'SRG' => 'Guilders',
  1.2116 +            'STD' => 'Dobras',
  1.2117 +            'SVC' => 'Colones',
  1.2118 +            'SYP' => 'Pounds',
  1.2119 +            'SZL' => 'Emalangeni',
  1.2120 +            'THB' => 'Baht',
  1.2121 +            'TJR' => 'Rubles',
  1.2122 +            'TMM' => 'Manats',
  1.2123 +            'TND' => 'Dinars',
  1.2124 +            'TOP' => 'Pa\'anga',
  1.2125 +            'TRL' => 'Liras',
  1.2126 +            'TTD' => 'Dollars',
  1.2127 +            'TVD' => 'Tuvalu Dollars',
  1.2128 +            'TWD' => 'New Dollars',
  1.2129 +            'TZS' => 'Shillings',
  1.2130 +            'UAH' => 'Hryvnia',
  1.2131 +            'UGX' => 'Shillings',
  1.2132 +            'USD' => 'Dollars',
  1.2133 +            'UYU' => 'Pesos',
  1.2134 +            'UZS' => 'Sums',
  1.2135 +            'VAL' => 'Lire',
  1.2136 +            'VEB' => 'Bolivares',
  1.2137 +            'VND' => 'Dong',
  1.2138 +            'VUV' => 'Vatu',
  1.2139 +            'WST' => 'Tala',
  1.2140 +            'XAF' => 'Francs',
  1.2141 +            'XAG' => 'Ounces',
  1.2142 +            'XAU' => 'Ounces',
  1.2143 +            'XCD' => 'Dollars',
  1.2144 +            'XDR' => 'Special Drawing Rights',
  1.2145 +            'XPD' => 'Ounces',
  1.2146 +            'XPF' => 'Francs',
  1.2147 +            'XPT' => 'Ounces',
  1.2148 +            'YER' => 'Rials',
  1.2149 +            'YUM' => 'New Dinars',
  1.2150 +            'ZAR' => 'Rand',
  1.2151 +            'ZMK' => 'Kwacha',
  1.2152 +            'ZWD' => 'Zimbabwe Dollars'
  1.2153 +        );
  1.2154 +
  1.2155 +        return @$lookup[$currency_id];
  1.2156 +    }
  1.2157 +
  1.2158 +
  1.2159 +
  1.2160 +    public static function LookupCurrencyCountry($currency_id) {
  1.2161 +
  1.2162 +        static $lookup = array (
  1.2163 +            'AED' => 'United Arab Emirates',
  1.2164 +            'AFA' => 'Afghanistan',
  1.2165 +            'ALL' => 'Albania',
  1.2166 +            'AMD' => 'Armenia',
  1.2167 +            'ANG' => 'Netherlands Antilles',
  1.2168 +            'AOA' => 'Angola',
  1.2169 +            'ARS' => 'Argentina',
  1.2170 +            'ATS' => 'Austria',
  1.2171 +            'AUD' => 'Australia',
  1.2172 +            'AWG' => 'Aruba',
  1.2173 +            'AZM' => 'Azerbaijan',
  1.2174 +            'BAM' => 'Bosnia and Herzegovina',
  1.2175 +            'BBD' => 'Barbados',
  1.2176 +            'BDT' => 'Bangladesh',
  1.2177 +            'BEF' => 'Belgium',
  1.2178 +            'BGL' => 'Bulgaria',
  1.2179 +            'BHD' => 'Bahrain',
  1.2180 +            'BIF' => 'Burundi',
  1.2181 +            'BMD' => 'Bermuda',
  1.2182 +            'BND' => 'Brunei Darussalam',
  1.2183 +            'BOB' => 'Bolivia',
  1.2184 +            'BRL' => 'Brazil',
  1.2185 +            'BSD' => 'Bahamas',
  1.2186 +            'BTN' => 'Bhutan',
  1.2187 +            'BWP' => 'Botswana',
  1.2188 +            'BYR' => 'Belarus',
  1.2189 +            'BZD' => 'Belize',
  1.2190 +            'CAD' => 'Canada',
  1.2191 +            'CDF' => 'Congo/Kinshasa',
  1.2192 +            'CHF' => 'Switzerland',
  1.2193 +            'CLP' => 'Chile',
  1.2194 +            'CNY' => 'China',
  1.2195 +            'COP' => 'Colombia',
  1.2196 +            'CRC' => 'Costa Rica',
  1.2197 +            'CUP' => 'Cuba',
  1.2198 +            'CVE' => 'Cape Verde',
  1.2199 +            'CYP' => 'Cyprus',
  1.2200 +            'CZK' => 'Czech Republic',
  1.2201 +            'DEM' => 'Germany',
  1.2202 +            'DJF' => 'Djibouti',
  1.2203 +            'DKK' => 'Denmark',
  1.2204 +            'DOP' => 'Dominican Republic',
  1.2205 +            'DZD' => 'Algeria',
  1.2206 +            'EEK' => 'Estonia',
  1.2207 +            'EGP' => 'Egypt',
  1.2208 +            'ERN' => 'Eritrea',
  1.2209 +            'ESP' => 'Spain',
  1.2210 +            'ETB' => 'Ethiopia',
  1.2211 +            'EUR' => 'Euro Member Countries',
  1.2212 +            'FIM' => 'Finland',
  1.2213 +            'FJD' => 'Fiji',
  1.2214 +            'FKP' => 'Falkland Islands (Malvinas)',
  1.2215 +            'FRF' => 'France',
  1.2216 +            'GBP' => 'United Kingdom',
  1.2217 +            'GEL' => 'Georgia',
  1.2218 +            'GGP' => 'Guernsey',
  1.2219 +            'GHC' => 'Ghana',
  1.2220 +            'GIP' => 'Gibraltar',
  1.2221 +            'GMD' => 'Gambia',
  1.2222 +            'GNF' => 'Guinea',
  1.2223 +            'GRD' => 'Greece',
  1.2224 +            'GTQ' => 'Guatemala',
  1.2225 +            'GYD' => 'Guyana',
  1.2226 +            'HKD' => 'Hong Kong',
  1.2227 +            'HNL' => 'Honduras',
  1.2228 +            'HRK' => 'Croatia',
  1.2229 +            'HTG' => 'Haiti',
  1.2230 +            'HUF' => 'Hungary',
  1.2231 +            'IDR' => 'Indonesia',
  1.2232 +            'IEP' => 'Ireland (Eire)',
  1.2233 +            'ILS' => 'Israel',
  1.2234 +            'IMP' => 'Isle of Man',
  1.2235 +            'INR' => 'India',
  1.2236 +            'IQD' => 'Iraq',
  1.2237 +            'IRR' => 'Iran',
  1.2238 +            'ISK' => 'Iceland',
  1.2239 +            'ITL' => 'Italy',
  1.2240 +            'JEP' => 'Jersey',
  1.2241 +            'JMD' => 'Jamaica',
  1.2242 +            'JOD' => 'Jordan',
  1.2243 +            'JPY' => 'Japan',
  1.2244 +            'KES' => 'Kenya',
  1.2245 +            'KGS' => 'Kyrgyzstan',
  1.2246 +            'KHR' => 'Cambodia',
  1.2247 +            'KMF' => 'Comoros',
  1.2248 +            'KPW' => 'Korea',
  1.2249 +            'KWD' => 'Kuwait',
  1.2250 +            'KYD' => 'Cayman Islands',
  1.2251 +            'KZT' => 'Kazakstan',
  1.2252 +            'LAK' => 'Laos',
  1.2253 +            'LBP' => 'Lebanon',
  1.2254 +            'LKR' => 'Sri Lanka',
  1.2255 +            'LRD' => 'Liberia',
  1.2256 +            'LSL' => 'Lesotho',
  1.2257 +            'LTL' => 'Lithuania',
  1.2258 +            'LUF' => 'Luxembourg',
  1.2259 +            'LVL' => 'Latvia',
  1.2260 +            'LYD' => 'Libya',
  1.2261 +            'MAD' => 'Morocco',
  1.2262 +            'MDL' => 'Moldova',
  1.2263 +            'MGF' => 'Madagascar',
  1.2264 +            'MKD' => 'Macedonia',
  1.2265 +            'MMK' => 'Myanmar (Burma)',
  1.2266 +            'MNT' => 'Mongolia',
  1.2267 +            'MOP' => 'Macau',
  1.2268 +            'MRO' => 'Mauritania',
  1.2269 +            'MTL' => 'Malta',
  1.2270 +            'MUR' => 'Mauritius',
  1.2271 +            'MVR' => 'Maldives (Maldive Islands)',
  1.2272 +            'MWK' => 'Malawi',
  1.2273 +            'MXN' => 'Mexico',
  1.2274 +            'MYR' => 'Malaysia',
  1.2275 +            'MZM' => 'Mozambique',
  1.2276 +            'NAD' => 'Namibia',
  1.2277 +            'NGN' => 'Nigeria',
  1.2278 +            'NIO' => 'Nicaragua',
  1.2279 +            'NLG' => 'Netherlands (Holland)',
  1.2280 +            'NOK' => 'Norway',
  1.2281 +            'NPR' => 'Nepal',
  1.2282 +            'NZD' => 'New Zealand',
  1.2283 +            'OMR' => 'Oman',
  1.2284 +            'PAB' => 'Panama',
  1.2285 +            'PEN' => 'Peru',
  1.2286 +            'PGK' => 'Papua New Guinea',
  1.2287 +            'PHP' => 'Philippines',
  1.2288 +            'PKR' => 'Pakistan',
  1.2289 +            'PLN' => 'Poland',
  1.2290 +            'PTE' => 'Portugal',
  1.2291 +            'PYG' => 'Paraguay',
  1.2292 +            'QAR' => 'Qatar',
  1.2293 +            'ROL' => 'Romania',
  1.2294 +            'RUR' => 'Russia',
  1.2295 +            'RWF' => 'Rwanda',
  1.2296 +            'SAR' => 'Saudi Arabia',
  1.2297 +            'SBD' => 'Solomon Islands',
  1.2298 +            'SCR' => 'Seychelles',
  1.2299 +            'SDD' => 'Sudan',
  1.2300 +            'SEK' => 'Sweden',
  1.2301 +            'SGD' => 'Singapore',
  1.2302 +            'SHP' => 'Saint Helena',
  1.2303 +            'SIT' => 'Slovenia',
  1.2304 +            'SKK' => 'Slovakia',
  1.2305 +            'SLL' => 'Sierra Leone',
  1.2306 +            'SOS' => 'Somalia',
  1.2307 +            'SPL' => 'Seborga',
  1.2308 +            'SRG' => 'Suriname',
  1.2309 +            'STD' => 'São Tome and Principe',
  1.2310 +            'SVC' => 'El Salvador',
  1.2311 +            'SYP' => 'Syria',
  1.2312 +            'SZL' => 'Swaziland',
  1.2313 +            'THB' => 'Thailand',
  1.2314 +            'TJR' => 'Tajikistan',
  1.2315 +            'TMM' => 'Turkmenistan',
  1.2316 +            'TND' => 'Tunisia',
  1.2317 +            'TOP' => 'Tonga',
  1.2318 +            'TRL' => 'Turkey',
  1.2319 +            'TTD' => 'Trinidad and Tobago',
  1.2320 +            'TVD' => 'Tuvalu',
  1.2321 +            'TWD' => 'Taiwan',
  1.2322 +            'TZS' => 'Tanzania',
  1.2323 +            'UAH' => 'Ukraine',
  1.2324 +            'UGX' => 'Uganda',
  1.2325 +            'USD' => 'United States of America',
  1.2326 +            'UYU' => 'Uruguay',
  1.2327 +            'UZS' => 'Uzbekistan',
  1.2328 +            'VAL' => 'Vatican City',
  1.2329 +            'VEB' => 'Venezuela',
  1.2330 +            'VND' => 'Viet Nam',
  1.2331 +            'VUV' => 'Vanuatu',
  1.2332 +            'WST' => 'Samoa',
  1.2333 +            'XAF' => 'Communauté Financière Africaine',
  1.2334 +            'XAG' => 'Silver',
  1.2335 +            'XAU' => 'Gold',
  1.2336 +            'XCD' => 'East Caribbean',
  1.2337 +            'XDR' => 'International Monetary Fund',
  1.2338 +            'XPD' => 'Palladium',
  1.2339 +            'XPF' => 'Comptoirs Français du Pacifique',
  1.2340 +            'XPT' => 'Platinum',
  1.2341 +            'YER' => 'Yemen',
  1.2342 +            'YUM' => 'Yugoslavia',
  1.2343 +            'ZAR' => 'South Africa',
  1.2344 +            'ZMK' => 'Zambia',
  1.2345 +            'ZWD' => 'Zimbabwe'
  1.2346 +        );
  1.2347 +        
  1.2348 +        return @$lookup[$currency_id];
  1.2349 +    }
  1.2350 +
  1.2351 +
  1.2352 +
  1.2353 +    public static function LanguageLookup($language_code, $case_sensitive=false) {
  1.2354 +
  1.2355 +        if (!$case_sensitive) {
  1.2356 +            $language_code = strtolower($language_code);
  1.2357 +        }
  1.2358 +
  1.2359 +        // http://www.id3.org/id3v2.4.0-structure.txt
  1.2360 +        // [4.   ID3v2 frame overview]
  1.2361 +        // The three byte language field, present in several frames, is used to
  1.2362 +        // describe the language of the frame's content, according to ISO-639-2
  1.2363 +        // [ISO-639-2]. The language should be represented in lower case. If the
  1.2364 +        // language is not known the string "XXX" should be used.
  1.2365 +
  1.2366 +
  1.2367 +        // ISO 639-2 - http://www.id3.org/iso639-2.html
  1.2368 +
  1.2369 +        static $lookup = array (
  1.2370 +            'XXX' => 'unknown',
  1.2371 +            'xxx' => 'unknown',
  1.2372 +            'aar' => 'Afar',
  1.2373 +            'abk' => 'Abkhazian',
  1.2374 +            'ace' => 'Achinese',
  1.2375 +            'ach' => 'Acoli',
  1.2376 +            'ada' => 'Adangme',
  1.2377 +            'afa' => 'Afro-Asiatic (Other)',
  1.2378 +            'afh' => 'Afrihili',
  1.2379 +            'afr' => 'Afrikaans',
  1.2380 +            'aka' => 'Akan',
  1.2381 +            'akk' => 'Akkadian',
  1.2382 +            'alb' => 'Albanian',
  1.2383 +            'ale' => 'Aleut',
  1.2384 +            'alg' => 'Algonquian Languages',
  1.2385 +            'amh' => 'Amharic',
  1.2386 +            'ang' => 'English, Old (ca. 450-1100)',
  1.2387 +            'apa' => 'Apache Languages',
  1.2388 +            'ara' => 'Arabic',
  1.2389 +            'arc' => 'Aramaic',
  1.2390 +            'arm' => 'Armenian',
  1.2391 +            'arn' => 'Araucanian',
  1.2392 +            'arp' => 'Arapaho',
  1.2393 +            'art' => 'Artificial (Other)',
  1.2394 +            'arw' => 'Arawak',
  1.2395 +            'asm' => 'Assamese',
  1.2396 +            'ath' => 'Athapascan Languages',
  1.2397 +            'ava' => 'Avaric',
  1.2398 +            'ave' => 'Avestan',
  1.2399 +            'awa' => 'Awadhi',
  1.2400 +            'aym' => 'Aymara',
  1.2401 +            'aze' => 'Azerbaijani',
  1.2402 +            'bad' => 'Banda',
  1.2403 +            'bai' => 'Bamileke Languages',
  1.2404 +            'bak' => 'Bashkir',
  1.2405 +            'bal' => 'Baluchi',
  1.2406 +            'bam' => 'Bambara',
  1.2407 +            'ban' => 'Balinese',
  1.2408 +            'baq' => 'Basque',
  1.2409 +            'bas' => 'Basa',
  1.2410 +            'bat' => 'Baltic (Other)',
  1.2411 +            'bej' => 'Beja',
  1.2412 +            'bel' => 'Byelorussian',
  1.2413 +            'bem' => 'Bemba',
  1.2414 +            'ben' => 'Bengali',
  1.2415 +            'ber' => 'Berber (Other)',
  1.2416 +            'bho' => 'Bhojpuri',
  1.2417 +            'bih' => 'Bihari',
  1.2418 +            'bik' => 'Bikol',
  1.2419 +            'bin' => 'Bini',
  1.2420 +            'bis' => 'Bislama',
  1.2421 +            'bla' => 'Siksika',
  1.2422 +            'bnt' => 'Bantu (Other)',
  1.2423 +            'bod' => 'Tibetan',
  1.2424 +            'bra' => 'Braj',
  1.2425 +            'bre' => 'Breton',
  1.2426 +            'bua' => 'Buriat',
  1.2427 +            'bug' => 'Buginese',
  1.2428 +            'bul' => 'Bulgarian',
  1.2429 +            'bur' => 'Burmese',
  1.2430 +            'cad' => 'Caddo',
  1.2431 +            'cai' => 'Central American Indian (Other)',
  1.2432 +            'car' => 'Carib',
  1.2433 +            'cat' => 'Catalan',
  1.2434 +            'cau' => 'Caucasian (Other)',
  1.2435 +            'ceb' => 'Cebuano',
  1.2436 +            'cel' => 'Celtic (Other)',
  1.2437 +            'ces' => 'Czech',
  1.2438 +            'cha' => 'Chamorro',
  1.2439 +            'chb' => 'Chibcha',
  1.2440 +            'che' => 'Chechen',
  1.2441 +            'chg' => 'Chagatai',
  1.2442 +            'chi' => 'Chinese',
  1.2443 +            'chm' => 'Mari',
  1.2444 +            'chn' => 'Chinook jargon',
  1.2445 +            'cho' => 'Choctaw',
  1.2446 +            'chr' => 'Cherokee',
  1.2447 +            'chu' => 'Church Slavic',
  1.2448 +            'chv' => 'Chuvash',
  1.2449 +            'chy' => 'Cheyenne',
  1.2450 +            'cop' => 'Coptic',
  1.2451 +            'cor' => 'Cornish',
  1.2452 +            'cos' => 'Corsican',
  1.2453 +            'cpe' => 'Creoles and Pidgins, English-based (Other)',
  1.2454 +            'cpf' => 'Creoles and Pidgins, French-based (Other)',
  1.2455 +            'cpp' => 'Creoles and Pidgins, Portuguese-based (Other)',
  1.2456 +            'cre' => 'Cree',
  1.2457 +            'crp' => 'Creoles and Pidgins (Other)',
  1.2458 +            'cus' => 'Cushitic (Other)',
  1.2459 +            'cym' => 'Welsh',
  1.2460 +            'cze' => 'Czech',
  1.2461 +            'dak' => 'Dakota',
  1.2462 +            'dan' => 'Danish',
  1.2463 +            'del' => 'Delaware',
  1.2464 +            'deu' => 'German',
  1.2465 +            'din' => 'Dinka',
  1.2466 +            'div' => 'Divehi',
  1.2467 +            'doi' => 'Dogri',
  1.2468 +            'dra' => 'Dravidian (Other)',
  1.2469 +            'dua' => 'Duala',
  1.2470 +            'dum' => 'Dutch, Middle (ca. 1050-1350)',
  1.2471 +            'dut' => 'Dutch',
  1.2472 +            'dyu' => 'Dyula',
  1.2473 +            'dzo' => 'Dzongkha',
  1.2474 +            'efi' => 'Efik',
  1.2475 +            'egy' => 'Egyptian (Ancient)',
  1.2476 +            'eka' => 'Ekajuk',
  1.2477 +            'ell' => 'Greek, Modern (1453-)',
  1.2478 +            'elx' => 'Elamite',
  1.2479 +            'eng' => 'English',
  1.2480 +            'enm' => 'English, Middle (ca. 1100-1500)',
  1.2481 +            'epo' => 'Esperanto',
  1.2482 +            'esk' => 'Eskimo (Other)',
  1.2483 +            'esl' => 'Spanish',
  1.2484 +            'est' => 'Estonian',
  1.2485 +            'eus' => 'Basque',
  1.2486 +            'ewe' => 'Ewe',
  1.2487 +            'ewo' => 'Ewondo',
  1.2488 +            'fan' => 'Fang',
  1.2489 +            'fao' => 'Faroese',
  1.2490 +            'fas' => 'Persian',
  1.2491 +            'fat' => 'Fanti',
  1.2492 +            'fij' => 'Fijian',
  1.2493 +            'fin' => 'Finnish',
  1.2494 +            'fiu' => 'Finno-Ugrian (Other)',
  1.2495 +            'fon' => 'Fon',
  1.2496 +            'fra' => 'French',
  1.2497 +            'fre' => 'French',
  1.2498 +            'frm' => 'French, Middle (ca. 1400-1600)',
  1.2499 +            'fro' => 'French, Old (842- ca. 1400)',
  1.2500 +            'fry' => 'Frisian',
  1.2501 +            'ful' => 'Fulah',
  1.2502 +            'gaa' => 'Ga',
  1.2503 +            'gae' => 'Gaelic (Scots)',
  1.2504 +            'gai' => 'Irish',
  1.2505 +            'gay' => 'Gayo',
  1.2506 +            'gdh' => 'Gaelic (Scots)',
  1.2507 +            'gem' => 'Germanic (Other)',
  1.2508 +            'geo' => 'Georgian',
  1.2509 +            'ger' => 'German',
  1.2510 +            'gez' => 'Geez',
  1.2511 +            'gil' => 'Gilbertese',
  1.2512 +            'glg' => 'Gallegan',
  1.2513 +            'gmh' => 'German, Middle High (ca. 1050-1500)',
  1.2514 +            'goh' => 'German, Old High (ca. 750-1050)',
  1.2515 +            'gon' => 'Gondi',
  1.2516 +            'got' => 'Gothic',
  1.2517 +            'grb' => 'Grebo',
  1.2518 +            'grc' => 'Greek, Ancient (to 1453)',
  1.2519 +            'gre' => 'Greek, Modern (1453-)',
  1.2520 +            'grn' => 'Guarani',
  1.2521 +            'guj' => 'Gujarati',
  1.2522 +            'hai' => 'Haida',
  1.2523 +            'hau' => 'Hausa',
  1.2524 +            'haw' => 'Hawaiian',
  1.2525 +            'heb' => 'Hebrew',
  1.2526 +            'her' => 'Herero',
  1.2527 +            'hil' => 'Hiligaynon',
  1.2528 +            'him' => 'Himachali',
  1.2529 +            'hin' => 'Hindi',
  1.2530 +            'hmo' => 'Hiri Motu',
  1.2531 +            'hun' => 'Hungarian',
  1.2532 +            'hup' => 'Hupa',
  1.2533 +            'hye' => 'Armenian',
  1.2534 +            'iba' => 'Iban',
  1.2535 +            'ibo' => 'Igbo',
  1.2536 +            'ice' => 'Icelandic',
  1.2537 +            'ijo' => 'Ijo',
  1.2538 +            'iku' => 'Inuktitut',
  1.2539 +            'ilo' => 'Iloko',
  1.2540 +            'ina' => 'Interlingua (International Auxiliary language Association)',
  1.2541 +            'inc' => 'Indic (Other)',
  1.2542 +            'ind' => 'Indonesian',
  1.2543 +            'ine' => 'Indo-European (Other)',
  1.2544 +            'ine' => 'Interlingue',
  1.2545 +            'ipk' => 'Inupiak',
  1.2546 +            'ira' => 'Iranian (Other)',
  1.2547 +            'iri' => 'Irish',
  1.2548 +            'iro' => 'Iroquoian uages',
  1.2549 +            'isl' => 'Icelandic',
  1.2550 +            'ita' => 'Italian',
  1.2551 +            'jav' => 'Javanese',
  1.2552 +            'jaw' => 'Javanese',
  1.2553 +            'jpn' => 'Japanese',
  1.2554 +            'jpr' => 'Judeo-Persian',
  1.2555 +            'jrb' => 'Judeo-Arabic',
  1.2556 +            'kaa' => 'Kara-Kalpak',
  1.2557 +            'kab' => 'Kabyle',
  1.2558 +            'kac' => 'Kachin',
  1.2559 +            'kal' => 'Greenlandic',
  1.2560 +            'kam' => 'Kamba',
  1.2561 +            'kan' => 'Kannada',
  1.2562 +            'kar' => 'Karen',
  1.2563 +            'kas' => 'Kashmiri',
  1.2564 +            'kat' => 'Georgian',
  1.2565 +            'kau' => 'Kanuri',
  1.2566 +            'kaw' => 'Kawi',
  1.2567 +            'kaz' => 'Kazakh',
  1.2568 +            'kha' => 'Khasi',
  1.2569 +            'khi' => 'Khoisan (Other)',
  1.2570 +            'khm' => 'Khmer',
  1.2571 +            'kho' => 'Khotanese',
  1.2572 +            'kik' => 'Kikuyu',
  1.2573 +            'kin' => 'Kinyarwanda',
  1.2574 +            'kir' => 'Kirghiz',
  1.2575 +            'kok' => 'Konkani',
  1.2576 +            'kom' => 'Komi',
  1.2577 +            'kon' => 'Kongo',
  1.2578 +            'kor' => 'Korean',
  1.2579 +            'kpe' => 'Kpelle',
  1.2580 +            'kro' => 'Kru',
  1.2581 +            'kru' => 'Kurukh',
  1.2582 +            'kua' => 'Kuanyama',
  1.2583 +            'kum' => 'Kumyk',
  1.2584 +            'kur' => 'Kurdish',
  1.2585 +            'kus' => 'Kusaie',
  1.2586 +            'kut' => 'Kutenai',
  1.2587 +            'lad' => 'Ladino',
  1.2588 +            'lah' => 'Lahnda',
  1.2589 +            'lam' => 'Lamba',
  1.2590 +            'lao' => 'Lao',
  1.2591 +            'lat' => 'Latin',
  1.2592 +            'lav' => 'Latvian',
  1.2593 +            'lez' => 'Lezghian',
  1.2594 +            'lin' => 'Lingala',
  1.2595 +            'lit' => 'Lithuanian',
  1.2596 +            'lol' => 'Mongo',
  1.2597 +            'loz' => 'Lozi',
  1.2598 +            'ltz' => 'Letzeburgesch',
  1.2599 +            'lub' => 'Luba-Katanga',
  1.2600 +            'lug' => 'Ganda',
  1.2601 +            'lui' => 'Luiseno',
  1.2602 +            'lun' => 'Lunda',
  1.2603 +            'luo' => 'Luo (Kenya and Tanzania)',
  1.2604 +            'mac' => 'Macedonian',
  1.2605 +            'mad' => 'Madurese',
  1.2606 +            'mag' => 'Magahi',
  1.2607 +            'mah' => 'Marshall',
  1.2608 +            'mai' => 'Maithili',
  1.2609 +            'mak' => 'Macedonian',
  1.2610 +            'mak' => 'Makasar',
  1.2611 +            'mal' => 'Malayalam',
  1.2612 +            'man' => 'Mandingo',
  1.2613 +            'mao' => 'Maori',
  1.2614 +            'map' => 'Austronesian (Other)',
  1.2615 +            'mar' => 'Marathi',
  1.2616 +            'mas' => 'Masai',
  1.2617 +            'max' => 'Manx',
  1.2618 +            'may' => 'Malay',
  1.2619 +            'men' => 'Mende',
  1.2620 +            'mga' => 'Irish, Middle (900 - 1200)',
  1.2621 +            'mic' => 'Micmac',
  1.2622 +            'min' => 'Minangkabau',
  1.2623 +            'mis' => 'Miscellaneous (Other)',
  1.2624 +            'mkh' => 'Mon-Kmer (Other)',
  1.2625 +            'mlg' => 'Malagasy',
  1.2626 +            'mlt' => 'Maltese',
  1.2627 +            'mni' => 'Manipuri',
  1.2628 +            'mno' => 'Manobo Languages',
  1.2629 +            'moh' => 'Mohawk',
  1.2630 +            'mol' => 'Moldavian',
  1.2631 +            'mon' => 'Mongolian',
  1.2632 +            'mos' => 'Mossi',
  1.2633 +            'mri' => 'Maori',
  1.2634 +            'msa' => 'Malay',
  1.2635 +            'mul' => 'Multiple Languages',
  1.2636 +            'mun' => 'Munda Languages',
  1.2637 +            'mus' => 'Creek',
  1.2638 +            'mwr' => 'Marwari',
  1.2639 +            'mya' => 'Burmese',
  1.2640 +            'myn' => 'Mayan Languages',
  1.2641 +            'nah' => 'Aztec',
  1.2642 +            'nai' => 'North American Indian (Other)',
  1.2643 +            'nau' => 'Nauru',
  1.2644 +            'nav' => 'Navajo',
  1.2645 +            'nbl' => 'Ndebele, South',
  1.2646 +            'nde' => 'Ndebele, North',
  1.2647 +            'ndo' => 'Ndongo',
  1.2648 +            'nep' => 'Nepali',
  1.2649 +            'new' => 'Newari',
  1.2650 +            'nic' => 'Niger-Kordofanian (Other)',
  1.2651 +            'niu' => 'Niuean',
  1.2652 +            'nla' => 'Dutch',
  1.2653 +            'nno' => 'Norwegian (Nynorsk)',
  1.2654 +            'non' => 'Norse, Old',
  1.2655 +            'nor' => 'Norwegian',
  1.2656 +            'nso' => 'Sotho, Northern',
  1.2657 +            'nub' => 'Nubian Languages',
  1.2658 +            'nya' => 'Nyanja',
  1.2659 +            'nym' => 'Nyamwezi',
  1.2660 +            'nyn' => 'Nyankole',
  1.2661 +            'nyo' => 'Nyoro',
  1.2662 +            'nzi' => 'Nzima',
  1.2663 +            'oci' => 'Langue d\'Oc (post 1500)',
  1.2664 +            'oji' => 'Ojibwa',
  1.2665 +            'ori' => 'Oriya',
  1.2666 +            'orm' => 'Oromo',
  1.2667 +            'osa' => 'Osage',
  1.2668 +            'oss' => 'Ossetic',
  1.2669 +            'ota' => 'Turkish, Ottoman (1500 - 1928)',
  1.2670 +            'oto' => 'Otomian Languages',
  1.2671 +            'paa' => 'Papuan-Australian (Other)',
  1.2672 +            'pag' => 'Pangasinan',
  1.2673 +            'pal' => 'Pahlavi',
  1.2674 +            'pam' => 'Pampanga',
  1.2675 +            'pan' => 'Panjabi',
  1.2676 +            'pap' => 'Papiamento',
  1.2677 +            'pau' => 'Palauan',
  1.2678 +            'peo' => 'Persian, Old (ca 600 - 400 B.C.)',
  1.2679 +            'per' => 'Persian',
  1.2680 +            'phn' => 'Phoenician',
  1.2681 +            'pli' => 'Pali',
  1.2682 +            'pol' => 'Polish',
  1.2683 +            'pon' => 'Ponape',
  1.2684 +            'por' => 'Portuguese',
  1.2685 +            'pra' => 'Prakrit uages',
  1.2686 +            'pro' => 'Provencal, Old (to 1500)',
  1.2687 +            'pus' => 'Pushto',
  1.2688 +            'que' => 'Quechua',
  1.2689 +            'raj' => 'Rajasthani',
  1.2690 +            'rar' => 'Rarotongan',
  1.2691 +            'roa' => 'Romance (Other)',
  1.2692 +            'roh' => 'Rhaeto-Romance',
  1.2693 +            'rom' => 'Romany',
  1.2694 +            'ron' => 'Romanian',
  1.2695 +            'rum' => 'Romanian',
  1.2696 +            'run' => 'Rundi',
  1.2697 +            'rus' => 'Russian',
  1.2698 +            'sad' => 'Sandawe',
  1.2699 +            'sag' => 'Sango',
  1.2700 +            'sah' => 'Yakut',
  1.2701 +            'sai' => 'South American Indian (Other)',
  1.2702 +            'sal' => 'Salishan Languages',
  1.2703 +            'sam' => 'Samaritan Aramaic',
  1.2704 +            'san' => 'Sanskrit',
  1.2705 +            'sco' => 'Scots',
  1.2706 +            'scr' => 'Serbo-Croatian',
  1.2707 +            'sel' => 'Selkup',
  1.2708 +            'sem' => 'Semitic (Other)',
  1.2709 +            'sga' => 'Irish, Old (to 900)',
  1.2710 +            'shn' => 'Shan',
  1.2711 +            'sid' => 'Sidamo',
  1.2712 +            'sin' => 'Singhalese',
  1.2713 +            'sio' => 'Siouan Languages',
  1.2714 +            'sit' => 'Sino-Tibetan (Other)',
  1.2715 +            'sla' => 'Slavic (Other)',
  1.2716 +            'slk' => 'Slovak',
  1.2717 +            'slo' => 'Slovak',
  1.2718 +            'slv' => 'Slovenian',
  1.2719 +            'smi' => 'Sami Languages',
  1.2720 +            'smo' => 'Samoan',
  1.2721 +            'sna' => 'Shona',
  1.2722 +            'snd' => 'Sindhi',
  1.2723 +            'sog' => 'Sogdian',
  1.2724 +            'som' => 'Somali',
  1.2725 +            'son' => 'Songhai',
  1.2726 +            'sot' => 'Sotho, Southern',
  1.2727 +            'spa' => 'Spanish',
  1.2728 +            'sqi' => 'Albanian',
  1.2729 +            'srd' => 'Sardinian',
  1.2730 +            'srr' => 'Serer',
  1.2731 +            'ssa' => 'Nilo-Saharan (Other)',
  1.2732 +            'ssw' => 'Siswant',
  1.2733 +            'ssw' => 'Swazi',
  1.2734 +            'suk' => 'Sukuma',
  1.2735 +            'sun' => 'Sudanese',
  1.2736 +            'sus' => 'Susu',
  1.2737 +            'sux' => 'Sumerian',
  1.2738 +            'sve' => 'Swedish',
  1.2739 +            'swa' => 'Swahili',
  1.2740 +            'swe' => 'Swedish',
  1.2741 +            'syr' => 'Syriac',
  1.2742 +            'tah' => 'Tahitian',
  1.2743 +            'tam' => 'Tamil',
  1.2744 +            'tat' => 'Tatar',
  1.2745 +            'tel' => 'Telugu',
  1.2746 +            'tem' => 'Timne',
  1.2747 +            'ter' => 'Tereno',
  1.2748 +            'tgk' => 'Tajik',
  1.2749 +            'tgl' => 'Tagalog',
  1.2750 +            'tha' => 'Thai',
  1.2751 +            'tib' => 'Tibetan',
  1.2752 +            'tig' => 'Tigre',
  1.2753 +            'tir' => 'Tigrinya',
  1.2754 +            'tiv' => 'Tivi',
  1.2755 +            'tli' => 'Tlingit',
  1.2756 +            'tmh' => 'Tamashek',
  1.2757 +            'tog' => 'Tonga (Nyasa)',
  1.2758 +            'ton' => 'Tonga (Tonga Islands)',
  1.2759 +            'tru' => 'Truk',
  1.2760 +            'tsi' => 'Tsimshian',
  1.2761 +            'tsn' => 'Tswana',
  1.2762 +            'tso' => 'Tsonga',
  1.2763 +            'tuk' => 'Turkmen',
  1.2764 +            'tum' => 'Tumbuka',
  1.2765 +            'tur' => 'Turkish',
  1.2766 +            'tut' => 'Altaic (Other)',
  1.2767 +            'twi' => 'Twi',
  1.2768 +            'tyv' => 'Tuvinian',
  1.2769 +            'uga' => 'Ugaritic',
  1.2770 +            'uig' => 'Uighur',
  1.2771 +            'ukr' => 'Ukrainian',
  1.2772 +            'umb' => 'Umbundu',
  1.2773 +            'und' => 'Undetermined',
  1.2774 +            'urd' => 'Urdu',
  1.2775 +            'uzb' => 'Uzbek',
  1.2776 +            'vai' => 'Vai',
  1.2777 +            'ven' => 'Venda',
  1.2778 +            'vie' => 'Vietnamese',
  1.2779 +            'vol' => 'Volapük',
  1.2780 +            'vot' => 'Votic',
  1.2781 +            'wak' => 'Wakashan Languages',
  1.2782 +            'wal' => 'Walamo',
  1.2783 +            'war' => 'Waray',
  1.2784 +            'was' => 'Washo',
  1.2785 +            'wel' => 'Welsh',
  1.2786 +            'wen' => 'Sorbian Languages',
  1.2787 +            'wol' => 'Wolof',
  1.2788 +            'xho' => 'Xhosa',
  1.2789 +            'yao' => 'Yao',
  1.2790 +            'yap' => 'Yap',
  1.2791 +            'yid' => 'Yiddish',
  1.2792 +            'yor' => 'Yoruba',
  1.2793 +            'zap' => 'Zapotec',
  1.2794 +            'zen' => 'Zenaga',
  1.2795 +            'zha' => 'Zhuang',
  1.2796 +            'zho' => 'Chinese',
  1.2797 +            'zul' => 'Zulu',
  1.2798 +            'zun' => 'Zuni'
  1.2799 +        );        
  1.2800 +
  1.2801 +        return @$lookup[$language_code];
  1.2802 +    }
  1.2803 +
  1.2804 +
  1.2805 +    
  1.2806 +    public static function ETCOEventLookup($index) {
  1.2807 +        
  1.2808 +        if (($index >= 0x17) && ($index <= 0xDF)) {
  1.2809 +            return 'reserved for future use';
  1.2810 +        }
  1.2811 +        if (($index >= 0xE0) && ($index <= 0xEF)) {
  1.2812 +            return 'not predefined synch 0-F';
  1.2813 +        }
  1.2814 +        if (($index >= 0xF0) && ($index <= 0xFC)) {
  1.2815 +            return 'reserved for future use';
  1.2816 +        }
  1.2817 +
  1.2818 +        static $lookup = array (
  1.2819 +            0x00 => 'padding (has no meaning)',
  1.2820 +            0x01 => 'end of initial silence',
  1.2821 +            0x02 => 'intro start',
  1.2822 +            0x03 => 'main part start',
  1.2823 +            0x04 => 'outro start',
  1.2824 +            0x05 => 'outro end',
  1.2825 +            0x06 => 'verse start',
  1.2826 +            0x07 => 'refrain start',
  1.2827 +            0x08 => 'interlude start',
  1.2828 +            0x09 => 'theme start',
  1.2829 +            0x0A => 'variation start',
  1.2830 +            0x0B => 'key change',
  1.2831 +            0x0C => 'time change',
  1.2832 +            0x0D => 'momentary unwanted noise (Snap, Crackle & Pop)',
  1.2833 +            0x0E => 'sustained noise',
  1.2834 +            0x0F => 'sustained noise end',
  1.2835 +            0x10 => 'intro end',
  1.2836 +            0x11 => 'main part end',
  1.2837 +            0x12 => 'verse end',
  1.2838 +            0x13 => 'refrain end',
  1.2839 +            0x14 => 'theme end',
  1.2840 +            0x15 => 'profanity',
  1.2841 +            0x16 => 'profanity end',
  1.2842 +            0xFD => 'audio end (start of silence)',
  1.2843 +            0xFE => 'audio file ends',
  1.2844 +            0xFF => 'one more byte of events follows'
  1.2845 +        );
  1.2846 +
  1.2847 +        return @$lookup[$index];
  1.2848 +    }
  1.2849 +
  1.2850 +
  1.2851 +
  1.2852 +    public static function SYTLContentTypeLookup($index) {
  1.2853 +
  1.2854 +        static $lookup = array (
  1.2855 +            0x00 => 'other',
  1.2856 +            0x01 => 'lyrics',
  1.2857 +            0x02 => 'text transcription',
  1.2858 +            0x03 => 'movement/part name', // (e.g. 'Adagio')
  1.2859 +            0x04 => 'events',             // (e.g. 'Don Quijote enters the stage')
  1.2860 +            0x05 => 'chord',              // (e.g. 'Bb F Fsus')
  1.2861 +            0x06 => 'trivia/\'pop up\' information',
  1.2862 +            0x07 => 'URLs to webpages',
  1.2863 +            0x08 => 'URLs to images'
  1.2864 +        );
  1.2865 +
  1.2866 +        return @$lookup[$index];
  1.2867 +    }
  1.2868 +
  1.2869 +
  1.2870 +
  1.2871 +    public static function APICPictureTypeLookup($index, $return_array=false) {
  1.2872 +
  1.2873 +        static $lookup = array (
  1.2874 +            0x00 => 'Other',
  1.2875 +            0x01 => '32x32 pixels \'file icon\' (PNG only)',
  1.2876 +            0x02 => 'Other file icon',
  1.2877 +            0x03 => 'Cover (front)',
  1.2878 +            0x04 => 'Cover (back)',
  1.2879 +            0x05 => 'Leaflet page',
  1.2880 +            0x06 => 'Media (e.g. label side of CD)',
  1.2881 +            0x07 => 'Lead artist/lead performer/soloist',
  1.2882 +            0x08 => 'Artist/performer',
  1.2883 +            0x09 => 'Conductor',
  1.2884 +            0x0A => 'Band/Orchestra',
  1.2885 +            0x0B => 'Composer',
  1.2886 +            0x0C => 'Lyricist/text writer',
  1.2887 +            0x0D => 'Recording Location',
  1.2888 +            0x0E => 'During recording',
  1.2889 +            0x0F => 'During performance',
  1.2890 +            0x10 => 'Movie/video screen capture',
  1.2891 +            0x11 => 'A bright coloured fish',
  1.2892 +            0x12 => 'Illustration',
  1.2893 +            0x13 => 'Band/artist logotype',
  1.2894 +            0x14 => 'Publisher/Studio logotype'
  1.2895 +        );
  1.2896 +        
  1.2897 +        if ($return_array) {
  1.2898 +            return $lookup;
  1.2899 +        }
  1.2900 +        return @$lookup[$index];
  1.2901 +    }
  1.2902 +
  1.2903 +
  1.2904 +
  1.2905 +    public static function COMRReceivedAsLookup($index) {
  1.2906 +
  1.2907 +        static $lookup = array (
  1.2908 +            0x00 => 'Other',
  1.2909 +            0x01 => 'Standard CD album with other songs',
  1.2910 +            0x02 => 'Compressed audio on CD',
  1.2911 +            0x03 => 'File over the Internet',
  1.2912 +            0x04 => 'Stream over the Internet',
  1.2913 +            0x05 => 'As note sheets',
  1.2914 +            0x06 => 'As note sheets in a book with other sheets',
  1.2915 +            0x07 => 'Music on other media',
  1.2916 +            0x08 => 'Non-musical merchandise'
  1.2917 +        );
  1.2918 +
  1.2919 +        return (isset($lookup[$index]) ? $lookup[$index] : '');
  1.2920 +    }
  1.2921 +
  1.2922 +
  1.2923 +
  1.2924 +    public static function RVA2ChannelTypeLookup($index) {
  1.2925 +        
  1.2926 +        static $lookup = array (
  1.2927 +            0x00 => 'Other',
  1.2928 +            0x01 => 'Master volume',
  1.2929 +            0x02 => 'Front right',
  1.2930 +            0x03 => 'Front left',
  1.2931 +            0x04 => 'Back right',
  1.2932 +            0x05 => 'Back left',
  1.2933 +            0x06 => 'Front centre',
  1.2934 +            0x07 => 'Back centre',
  1.2935 +            0x08 => 'Subwoofer'
  1.2936 +        );
  1.2937 +
  1.2938 +        return @$lookup[$index];
  1.2939 +    }
  1.2940 +
  1.2941 +
  1.2942 +
  1.2943 +    public static function FrameNameLongLookup($frame_name) {
  1.2944 +
  1.2945 +        static $lookup = array (
  1.2946 +            'AENC' => 'Audio encryption',
  1.2947 +            'APIC' => 'Attached picture',
  1.2948 +            'ASPI' => 'Audio seek point index',
  1.2949 +            'BUF'  => 'Recommended buffer size',
  1.2950 +            'CNT'  => 'Play counter',
  1.2951 +            'COM'  => 'Comments',
  1.2952 +            'COMM' => 'Comments',
  1.2953 +            'COMR' => 'Commercial frame',
  1.2954 +            'CRA'  => 'Audio encryption',
  1.2955 +            'CRM'  => 'Encrypted meta frame',
  1.2956 +            'ENCR' => 'Encryption method registration',
  1.2957 +            'EQU'  => 'Equalisation',
  1.2958 +            'EQU2' => 'Equalisation (2)',
  1.2959 +            'EQUA' => 'Equalisation',
  1.2960 +            'ETC'  => 'Event timing codes',
  1.2961 +            'ETCO' => 'Event timing codes',
  1.2962 +            'GEO'  => 'General encapsulated object',
  1.2963 +            'GEOB' => 'General encapsulated object',
  1.2964 +            'GRID' => 'Group identification registration',
  1.2965 +            'IPL'  => 'Involved people list',
  1.2966 +            'IPLS' => 'Involved people list',
  1.2967 +            'LINK' => 'Linked information',
  1.2968 +            'LNK'  => 'Linked information',
  1.2969 +            'MCDI' => 'Music CD identifier',
  1.2970 +            'MCI'  => 'Music CD Identifier',
  1.2971 +            'MLL'  => 'MPEG location lookup table',
  1.2972 +            'MLLT' => 'MPEG location lookup table',
  1.2973 +            'OWNE' => 'Ownership frame',
  1.2974 +            'PCNT' => 'Play counter',
  1.2975 +            'PIC'  => 'Attached picture',
  1.2976 +            'POP'  => 'Popularimeter',
  1.2977 +            'POPM' => 'Popularimeter',
  1.2978 +            'POSS' => 'Position synchronisation frame',
  1.2979 +            'PRIV' => 'Private frame',
  1.2980 +            'RBUF' => 'Recommended buffer size',
  1.2981 +            'REV'  => 'Reverb',
  1.2982 +            'RVA'  => 'Relative volume adjustment',
  1.2983 +            'RVA2' => 'Relative volume adjustment (2)',
  1.2984 +            'RVAD' => 'Relative volume adjustment',
  1.2985 +            'RVRB' => 'Reverb',
  1.2986 +            'SEEK' => 'Seek frame',
  1.2987 +            'SIGN' => 'Signature frame',
  1.2988 +            'SLT'  => 'Synchronised lyric/text',
  1.2989 +            'STC'  => 'Synced tempo codes',
  1.2990 +            'SYLT' => 'Synchronised lyric/text',
  1.2991 +            'SYTC' => 'Synchronised tempo codes',
  1.2992 +            'TAL'  => 'Album/Movie/Show title',
  1.2993 +            'TALB' => 'Album/Movie/Show title',
  1.2994 +            'TBP'  => 'BPM (Beats Per Minute)',
  1.2995 +            'TBPM' => 'BPM (beats per minute)',
  1.2996 +            'TCM'  => 'Composer',
  1.2997 +            'TCO'  => 'Content type',
  1.2998 +            'TCOM' => 'Composer',
  1.2999 +            'TCON' => 'Content type',
  1.3000 +            'TCOP' => 'Copyright message',
  1.3001 +            'TCR'  => 'Copyright message',
  1.3002 +            'TDA'  => 'Date',
  1.3003 +            'TDAT' => 'Date',
  1.3004 +            'TDEN' => 'Encoding time',
  1.3005 +            'TDLY' => 'Playlist delay',
  1.3006 +            'TDOR' => 'Original release time',
  1.3007 +            'TDRC' => 'Recording time',
  1.3008 +            'TDRL' => 'Release time',
  1.3009 +            'TDTG' => 'Tagging time',
  1.3010 +            'TDY'  => 'Playlist delay',
  1.3011 +            'TEN'  => 'Encoded by',
  1.3012 +            'TENC' => 'Encoded by',
  1.3013 +            'TEXT' => 'Lyricist/Text writer',
  1.3014 +            'TFLT' => 'File type',
  1.3015 +            'TFT'  => 'File type',
  1.3016 +            'TIM'  => 'Time',
  1.3017 +            'TIME' => 'Time',
  1.3018 +            'TIPL' => 'Involved people list',
  1.3019 +            'TIT1' => 'Content group description',
  1.3020 +            'TIT2' => 'Title/songname/content description',
  1.3021 +            'TIT3' => 'Subtitle/Description refinement',
  1.3022 +            'TKE'  => 'Initial key',
  1.3023 +            'TKEY' => 'Initial key',
  1.3024 +            'TLA'  => 'Language(s)',
  1.3025 +            'TLAN' => 'Language(s)',
  1.3026 +            'TLE'  => 'Length',
  1.3027 +            'TLEN' => 'Length',
  1.3028 +            'TMCL' => 'Musician credits list',
  1.3029 +            'TMED' => 'Media type',
  1.3030 +            'TMOO' => 'Mood',
  1.3031 +            'TMT'  => 'Media type',
  1.3032 +            'TOA'  => 'Original artist(s)/performer(s)',
  1.3033 +            'TOAL' => 'Original album/movie/show title',
  1.3034 +            'TOF'  => 'Original filename',
  1.3035 +            'TOFN' => 'Original filename',
  1.3036 +            'TOL'  => 'Original Lyricist(s)/text writer(s)',
  1.3037 +            'TOLY' => 'Original lyricist(s)/text writer(s)',
  1.3038 +            'TOPE' => 'Original artist(s)/performer(s)',
  1.3039 +            'TOR'  => 'Original release year',
  1.3040 +            'TORY' => 'Original release year',
  1.3041 +            'TOT'  => 'Original album/Movie/Show title',
  1.3042 +            'TOWN' => 'File owner/licensee',
  1.3043 +            'TP1'  => 'Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group',
  1.3044 +            'TP2'  => 'Band/Orchestra/Accompaniment',
  1.3045 +            'TP3'  => 'Conductor/Performer refinement',
  1.3046 +            'TP4'  => 'Interpreted, remixed, or otherwise modified by',
  1.3047 +            'TPA'  => 'Part of a set',
  1.3048 +            'TPB'  => 'Publisher',
  1.3049 +            'TPE1' => 'Lead performer(s)/Soloist(s)',
  1.3050 +            'TPE2' => 'Band/orchestra/accompaniment',
  1.3051 +            'TPE3' => 'Conductor/performer refinement',
  1.3052 +            'TPE4' => 'Interpreted, remixed, or otherwise modified by',
  1.3053 +            'TPOS' => 'Part of a set',
  1.3054 +            'TPRO' => 'Produced notice',
  1.3055 +            'TPUB' => 'Publisher',
  1.3056 +            'TRC'  => 'ISRC (International Standard Recording Code)',
  1.3057 +            'TRCK' => 'Track number/Position in set',
  1.3058 +            'TRD'  => 'Recording dates',
  1.3059 +            'TRDA' => 'Recording dates',
  1.3060 +            'TRK'  => 'Track number/Position in set',
  1.3061 +            'TRSN' => 'Internet radio station name',
  1.3062 +            'TRSO' => 'Internet radio station owner',
  1.3063 +            'TSI'  => 'Size',
  1.3064 +            'TSIZ' => 'Size',
  1.3065 +            'TSOA' => 'Album sort order',
  1.3066 +            'TSOP' => 'Performer sort order',
  1.3067 +            'TSOT' => 'Title sort order',
  1.3068 +            'TSRC' => 'ISRC (international standard recording code)',
  1.3069 +            'TSS'  => 'Software/hardware and settings used for encoding',
  1.3070 +            'TSSE' => 'Software/Hardware and settings used for encoding',
  1.3071 +            'TSST' => 'Set subtitle',
  1.3072 +            'TT1'  => 'Content group description',
  1.3073 +            'TT2'  => 'Title/Songname/Content description',
  1.3074 +            'TT3'  => 'Subtitle/Description refinement',
  1.3075 +            'TXT'  => 'Lyricist/text writer',
  1.3076 +            'TXX'  => 'User defined text information frame',
  1.3077 +            'TXXX' => 'User defined text information frame',
  1.3078 +            'TYE'  => 'Year',
  1.3079 +            'TYER' => 'Year',
  1.3080 +            'UFI'  => 'Unique file identifier',
  1.3081 +            'UFID' => 'Unique file identifier',
  1.3082 +            'ULT'  => 'Unsychronised lyric/text transcription',
  1.3083 +            'USER' => 'Terms of use',
  1.3084 +            'USLT' => 'Unsynchronised lyric/text transcription',
  1.3085 +            'WAF'  => 'Official audio file webpage',
  1.3086 +            'WAR'  => 'Official artist/performer webpage',
  1.3087 +            'WAS'  => 'Official audio source webpage',
  1.3088 +            'WCM'  => 'Commercial information',
  1.3089 +            'WCOM' => 'Commercial information',
  1.3090 +            'WCOP' => 'Copyright/Legal information',
  1.3091 +            'WCP'  => 'Copyright/Legal information',
  1.3092 +            'WOAF' => 'Official audio file webpage',
  1.3093 +            'WOAR' => 'Official artist/performer webpage',
  1.3094 +            'WOAS' => 'Official audio source webpage',
  1.3095 +            'WORS' => 'Official Internet radio station homepage',
  1.3096 +            'WPAY' => 'Payment',
  1.3097 +            'WPB'  => 'Publishers official webpage',
  1.3098 +            'WPUB' => 'Publishers official webpage',
  1.3099 +            'WXX'  => 'User defined URL link frame',
  1.3100 +            'WXXX' => 'User defined URL link frame',
  1.3101 +            'TFEA' => 'Featured Artist',
  1.3102 +            'TSTU' => 'Recording Studio',
  1.3103 +            'rgad' => 'Replay Gain Adjustment'
  1.3104 +        );        
  1.3105 +        
  1.3106 +        return @$lookup[$frame_name];
  1.3107 +
  1.3108 +        // Last three:
  1.3109 +        // from Helium2 [www.helium2.com]
  1.3110 +        // from http://privatewww.essex.ac.uk/~djmrob/replaygain/file_format_id3v2.html
  1.3111 +    }
  1.3112 +
  1.3113 +
  1.3114 +    public static function FrameNameShortLookup($frame_name) {
  1.3115 +
  1.3116 +        static $lookup = array (
  1.3117 +            'COM'  => 'comment',
  1.3118 +            'COMM' => 'comment',
  1.3119 +            'TAL'  => 'album',
  1.3120 +            'TALB' => 'album',
  1.3121 +            'TBP'  => 'bpm',
  1.3122 +            'TBPM' => 'bpm',
  1.3123 +            'TCM'  => 'composer',
  1.3124 +            'TCO'  => 'genre',
  1.3125 +            'TCOM' => 'composer',
  1.3126 +            'TCON' => 'genre',
  1.3127 +            'TCOP' => 'copyright',
  1.3128 +            'TCR'  => 'copyright',
  1.3129 +            'TEN'  => 'encoded_by',
  1.3130 +            'TENC' => 'encoded_by',
  1.3131 +            'TEXT' => 'lyricist',
  1.3132 +            'TIT1' => 'description',
  1.3133 +            'TIT2' => 'title',
  1.3134 +            'TIT3' => 'subtitle',
  1.3135 +            'TLA'  => 'language',
  1.3136 +            'TLAN' => 'language',
  1.3137 +            'TLE'  => 'length',
  1.3138 +            'TLEN' => 'length',
  1.3139 +            'TMOO' => 'mood',
  1.3140 +            'TOA'  => 'original_artist',
  1.3141 +            'TOAL' => 'original_album',
  1.3142 +            'TOF'  => 'original_filename',
  1.3143 +            'TOFN' => 'original_filename',
  1.3144 +            'TOL'  => 'original_lyricist',
  1.3145 +            'TOLY' => 'original_lyricist',
  1.3146 +            'TOPE' => 'original_artist',
  1.3147 +            'TOT'  => 'original_album',
  1.3148 +            'TP1'  => 'artist',
  1.3149 +            'TP2'  => 'band',
  1.3150 +            'TP3'  => 'conductor',
  1.3151 +            'TP4'  => 'remixer',
  1.3152 +            'TPB'  => 'publisher',
  1.3153 +            'TPE1' => 'artist',
  1.3154 +            'TPE2' => 'band',
  1.3155 +            'TPE3' => 'conductor',
  1.3156 +            'TPE4' => 'remixer',
  1.3157 +            'TPUB' => 'publisher',
  1.3158 +            'TRC'  => 'isrc',
  1.3159 +            'TRCK' => 'track',
  1.3160 +            'TRK'  => 'track',
  1.3161 +            'TSI'  => 'size',
  1.3162 +            'TSIZ' => 'size',
  1.3163 +            'TSRC' => 'isrc',
  1.3164 +            'TSS'  => 'encoder_settings',
  1.3165 +            'TSSE' => 'encoder_settings',
  1.3166 +            'TSST' => 'subtitle',
  1.3167 +            'TT1'  => 'description',
  1.3168 +            'TT2'  => 'title',
  1.3169 +            'TT3'  => 'subtitle',
  1.3170 +            'TXT'  => 'lyricist',
  1.3171 +            'TXX'  => 'text',
  1.3172 +            'TXXX' => 'text',
  1.3173 +            'TYE'  => 'year',
  1.3174 +            'TYER' => 'year',
  1.3175 +            'UFI'  => 'unique_file_identifier',
  1.3176 +            'UFID' => 'unique_file_identifier',
  1.3177 +            'ULT'  => 'unsychronised_lyric',
  1.3178 +            'USER' => 'terms_of_use',
  1.3179 +            'USLT' => 'unsynchronised lyric',
  1.3180 +            'WAF'  => 'url_file',
  1.3181 +            'WAR'  => 'url_artist',
  1.3182 +            'WAS'  => 'url_source',
  1.3183 +            'WCOP' => 'copyright',
  1.3184 +            'WCP'  => 'copyright',
  1.3185 +            'WOAF' => 'url_file',
  1.3186 +            'WOAR' => 'url_artist',
  1.3187 +            'WOAS' => 'url_source',
  1.3188 +            'WORS' => 'url_station',
  1.3189 +            'WPB'  => 'url_publisher',
  1.3190 +            'WPUB' => 'url_publisher',
  1.3191 +            'WXX'  => 'url_user',
  1.3192 +            'WXXX' => 'url_user',
  1.3193 +            'TFEA' => 'featured_artist',
  1.3194 +            'TSTU' => 'studio'
  1.3195 +        );
  1.3196 +
  1.3197 +        return @$lookup[$frame_name];
  1.3198 +    }
  1.3199 +
  1.3200 +
  1.3201 +
  1.3202 +    public static function TextEncodingTerminatorLookup($encoding) {
  1.3203 +
  1.3204 +        // http://www.id3.org/id3v2.4.0-structure.txt
  1.3205 +        // Frames that allow different types of text encoding contains a text encoding description byte. Possible encodings:
  1.3206 +        // $00  ISO-8859-1. Terminated with $00.
  1.3207 +        // $01  UTF-16 encoded Unicode with BOM. All strings in the same frame SHALL have the same byteorder. Terminated with $00 00.
  1.3208 +        // $02  UTF-16BE encoded Unicode without BOM. Terminated with $00 00.
  1.3209 +        // $03  UTF-8 encoded Unicode. Terminated with $00.
  1.3210 +
  1.3211 +        static $lookup = array (
  1.3212 +            0   => "\x00", 
  1.3213 +            1   => "\x00\x00", 
  1.3214 +            2   => "\x00\x00", 
  1.3215 +            3   => "\x00", 
  1.3216 +            255 => "\x00\x00"
  1.3217 +        );
  1.3218 +
  1.3219 +        return @$lookup[$encoding];
  1.3220 +    }
  1.3221 +
  1.3222 +
  1.3223 +
  1.3224 +    public static function IsValidID3v2FrameName($frame_name, $id3v2_major_version) {
  1.3225 +
  1.3226 +        switch ($id3v2_major_version) {
  1.3227 +            case 2:
  1.3228 +                return preg_match('/[A-Z][A-Z0-9]{2}/', $frame_name);
  1.3229 +
  1.3230 +            case 3:
  1.3231 +            case 4:
  1.3232 +                return preg_match('/[A-Z][A-Z0-9]{3}/', $frame_name);
  1.3233 +        }
  1.3234 +        return false;
  1.3235 +    }
  1.3236 +
  1.3237 +
  1.3238 +
  1.3239 +    public static function IsValidDateStampString($date_stamp) {
  1.3240 +
  1.3241 +        if (strlen($date_stamp) != 8) {
  1.3242 +            return false;
  1.3243 +        }
  1.3244 +        if ((int)$date_stamp) {
  1.3245 +            return false;
  1.3246 +        }
  1.3247 +        
  1.3248 +        $year  = substr($date_stamp, 0, 4);
  1.3249 +        $month = substr($date_stamp, 4, 2);
  1.3250 +        $day   = substr($date_stamp, 6, 2);
  1.3251 +        if (!$year  ||  !$month  ||  !$day  ||  $month > 12  ||  $day > 31 ) {
  1.3252 +            return false;
  1.3253 +        }
  1.3254 +        if (($day > 30) && (($month == 4) || ($month == 6) || ($month == 9) || ($month == 11))) {
  1.3255 +            return false;
  1.3256 +        }
  1.3257 +        if (($day > 29) && ($month == 2)) {
  1.3258 +            return false;
  1.3259 +        }
  1.3260 +        return true;
  1.3261 +    }
  1.3262 +    
  1.3263 +    
  1.3264 +
  1.3265 +    public static function array_merge_noclobber($array1, $array2) {
  1.3266 +        if (!is_array($array1) || !is_array($array2)) {
  1.3267 +            return false;
  1.3268 +        }
  1.3269 +        $newarray = $array1;
  1.3270 +        foreach ($array2 as $key => $val) {
  1.3271 +            if (is_array($val) && isset($newarray[$key]) && is_array($newarray[$key])) {
  1.3272 +                $newarray[$key] = getid3_id3v2::array_merge_noclobber($newarray[$key], $val);
  1.3273 +            } elseif (!isset($newarray[$key])) {
  1.3274 +                $newarray[$key] = $val;
  1.3275 +            }
  1.3276 +        }
  1.3277 +        return $newarray;
  1.3278 +    }
  1.3279 +
  1.3280 +
  1.3281 +}
  1.3282 +
  1.3283 +?>
  1.3284 \ No newline at end of file