/common/libraries/plugin/osflvplayer/flash/module.tag.id3v2.php

Large files files are truncated, but you can click here to view the full file

<?php

/////////////////////////////////////////////////////////////////
/// getID3() by James Heinrich <info@getid3.org>               //
//  available at http://getid3.sourceforge.net                 //
//            or http://www.getid3.org                         //
/////////////////////////////////////////////////////////////////
// See readme.txt for more details                             //
/////////////////////////////////////////////////////////////////
///                                                            //
// module.tag.id3v2.php                                        //
// module for analyzing ID3v2 tags                             //
// dependencies: module.tag.id3v1.php                          //
//                                                            ///
/////////////////////////////////////////////////////////////////




getid3_lib :: IncludeDependency(GETID3_INCLUDEPATH . 'module.tag.id3v1.php', __FILE__, true);



class getid3_id3v2

{



    function getid3_id3v2(&$fd, &$ThisFileInfo, $StartingOffset = 0)

    {

        //    Overall tag structure:
        //        +-----------------------------+
        //        |      Header (10 bytes)      |
        //        +-----------------------------+
        //        |       Extended Header       |
        //        | (variable length, OPTIONAL) |
        //        +-----------------------------+
        //        |   Frames (variable length)  |
        //        +-----------------------------+
        //        |           Padding           |
        //        | (variable length, OPTIONAL) |
        //        +-----------------------------+
        //        | Footer (10 bytes, OPTIONAL) |
        //        +-----------------------------+
        



        //    Header
        //        ID3v2/file identifier      "ID3"
        //        ID3v2 version              $04 00
        //        ID3v2 flags                (%ab000000 in v2.2, %abc00000 in v2.3, %abcd0000 in v2.4.x)
        //        ID3v2 size             4 * %0xxxxxxx
        



        // shortcuts
        $ThisFileInfo['id3v2']['header'] = true;

        $thisfile_id3v2 = &$ThisFileInfo['id3v2'];

        $thisfile_id3v2['flags'] = array();

        $thisfile_id3v2_flags = &$thisfile_id3v2['flags'];

        

        fseek($fd, $StartingOffset, SEEK_SET);

        $header = fread($fd, 10);

        if (substr($header, 0, 3) == 'ID3')

        {

            

            $thisfile_id3v2['majorversion'] = ord($header{3});

            $thisfile_id3v2['minorversion'] = ord($header{4});

            

            // shortcut
            $id3v2_majorversion = &$thisfile_id3v2['majorversion'];

        

        }

        else

        {

            

            unset($ThisFileInfo['id3v2']);

            return false;

        

        }

        

        if ($id3v2_majorversion > 4)

        { // this script probably won't correctly parse ID3v2.5.x and above (if it ever exists)
            



            $ThisFileInfo['error'][] = 'this script only parses up to ID3v2.4.x - this tag is ID3v2.' . $id3v2_majorversion . '.' . $thisfile_id3v2['minorversion'];

            return false;

        

        }

        

        $id3_flags = ord($header{5});

        switch ($id3v2_majorversion)

        {

            case 2 :

                // %ab000000 in v2.2
                $thisfile_id3v2_flags['unsynch'] = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
                $thisfile_id3v2_flags['compression'] = (bool) ($id3_flags & 0x40); // b - Compression
                break;

            

            case 3 :

                // %abc00000 in v2.3
                $thisfile_id3v2_flags['unsynch'] = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
                $thisfile_id3v2_flags['exthead'] = (bool) ($id3_flags & 0x40); // b - Extended header
                $thisfile_id3v2_flags['experim'] = (bool) ($id3_flags & 0x20); // c - Experimental indicator
                break;

            

            case 4 :

                // %abcd0000 in v2.4
                $thisfile_id3v2_flags['unsynch'] = (bool) ($id3_flags & 0x80); // a - Unsynchronisation
                $thisfile_id3v2_flags['exthead'] = (bool) ($id3_flags & 0x40); // b - Extended header
                $thisfile_id3v2_flags['experim'] = (bool) ($id3_flags & 0x20); // c - Experimental indicator
                $thisfile_id3v2_flags['isfooter'] = (bool) ($id3_flags & 0x10); // d - Footer present
                break;

        }

        

        $thisfile_id3v2['headerlength'] = getid3_lib :: BigEndian2Int(substr($header, 6, 4), 1) + 10; // length of ID3v2 tag in 10-byte header doesn't include 10-byte header length
        



        $thisfile_id3v2['tag_offset_start'] = $StartingOffset;

        $thisfile_id3v2['tag_offset_end'] = $thisfile_id3v2['tag_offset_start'] + $thisfile_id3v2['headerlength'];

        

        //    Extended Header
        if (isset($thisfile_id3v2_flags['exthead']) && $thisfile_id3v2_flags['exthead'])

        {

            // Extended header size   4 * %0xxxxxxx
            // Number of flag bytes       $01
            // Extended Flags             $xx
            // Where the 'Extended header size' is the size of the whole extended header, stored as a 32 bit synchsafe integer.
            $thisfile_id3v2['exthead_length'] = getid3_lib :: BigEndian2Int(fread($fd, 4), 1);

            

            $thisfile_id3v2['exthead_flag_bytes'] = ord(fread($fd, 1));

            if ($thisfile_id3v2['exthead_flag_bytes'] == 1)

            {

                // The extended flags field, with its size described by 'number of flag  bytes', is defined as:
                //     %0bcd0000
                // b - Tag is an update
                //     Flag data length       $00
                // c - CRC data present
                //     Flag data length       $05
                //     Total frame CRC    5 * %0xxxxxxx
                // d - Tag restrictions
                //     Flag data length       $01
                $extheaderflags = fread($fd, $thisfile_id3v2['exthead_flag_bytes']);

                $id3_exthead_flags = getid3_lib :: BigEndian2Bin(substr($header, 5, 1));

                $thisfile_id3v2['exthead_flags']['update'] = substr($id3_exthead_flags, 1, 1);

                $thisfile_id3v2['exthead_flags']['CRC'] = substr($id3_exthead_flags, 2, 1);

                if ($thisfile_id3v2['exthead_flags']['CRC'])

                {

                    $extheaderrawCRC = fread($fd, 5);

                    $thisfile_id3v2['exthead_flags']['CRC'] = getid3_lib :: BigEndian2Int($extheaderrawCRC, 1);

                }

                $thisfile_id3v2['exthead_flags']['restrictions'] = substr($id3_exthead_flags, 3, 1);

                if ($thisfile_id3v2['exthead_flags']['restrictions'])

                {

                    // Restrictions           %ppqrrstt
                    $extheaderrawrestrictions = fread($fd, 1);

                    $thisfile_id3v2['exthead_flags']['restrictions_tagsize'] = (bindec('11000000') & ord($extheaderrawrestrictions)) >> 6; // p - Tag size restrictions
                    $thisfile_id3v2['exthead_flags']['restrictions_textenc'] = (bindec('00100000') & ord($extheaderrawrestrictions)) >> 5; // q - Text encoding restrictions
                    $thisfile_id3v2['exthead_flags']['restrictions_textsize'] = (bindec('00011000') & ord($extheaderrawrestrictions)) >> 3; // r - Text fields size restrictions
                    $thisfile_id3v2['exthead_flags']['restrictions_imgenc'] = (bindec('00000100') & ord($extheaderrawrestrictions)) >> 2; // s - Image encoding restrictions
                    $thisfile_id3v2['exthead_flags']['restrictions_imgsize'] = (bindec('00000011') & ord($extheaderrawrestrictions)) >> 0; // t - Image size restrictions
                }

            }

            else

            {

                $ThisFileInfo['warning'][] = '$thisfile_id3v2[exthead_flag_bytes] = "' . $thisfile_id3v2['exthead_flag_bytes'] . '" (expecting "1")';

                fseek($fd, $thisfile_id3v2['exthead_length'] - 1, SEEK_CUR);

            

     //return false;
            }

        } // end extended header
        



        // create 'encoding' key - used by getid3::HandleAllTags()
        // in ID3v2 every field can have it's own encoding type
        // so force everything to UTF-8 so it can be handled consistantly
        $thisfile_id3v2['encoding'] = 'UTF-8';

        

        //    Frames
        



        //        All ID3v2 frames consists of one frame header followed by one or more
        //        fields containing the actual information. The header is always 10
        //        bytes and laid out as follows:
        //
        //        Frame ID      $xx xx xx xx  (four characters)
        //        Size      4 * %0xxxxxxx
        //        Flags         $xx xx
        



        $sizeofframes = $thisfile_id3v2['headerlength'] - 10; // not including 10-byte initial header
        if (@$thisfile_id3v2['exthead_length'])

        {

            $sizeofframes -= ($thisfile_id3v2['exthead_length'] + 4);

        }

        if (@$thisfile_id3v2_flags['isfooter'])

        {

            $sizeofframes -= 10; // footer takes last 10 bytes of ID3v2 header, after frame data, before audio
        }

        if ($sizeofframes > 0)

        {

            

            $framedata = fread($fd, $sizeofframes); // read all frames from file into $framedata variable
            



            //    if entire frame data is unsynched, de-unsynch it now (ID3v2.3.x)
            if (@$thisfile_id3v2_flags['unsynch'] && ($id3v2_majorversion <= 3))

            {

                $framedata = $this->DeUnsynchronise($framedata);

            }

            //        [in ID3v2.4.0] Unsynchronisation [S:6.1] is done on frame level, instead
            //        of on tag level, making it easier to skip frames, increasing the streamability
            //        of the tag. The unsynchronisation flag in the header [S:3.1] indicates that
            //        there exists an unsynchronised frame, while the new unsynchronisation flag in
            //        the frame header [S:4.1.2] indicates unsynchronisation.
            



            $framedataoffset = 10 + (@$thisfile_id3v2['exthead_length'] ? $thisfile_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)
            while (isset($framedata) && (strlen($framedata) > 0))

            { // cycle through until no more frame data is left to parse
                if (strlen($framedata) <= $this->ID3v2HeaderLength($id3v2_majorversion))

                {

                    // insufficient room left in ID3v2 header for actual data - must be padding
                    $thisfile_id3v2['padding']['start'] = $framedataoffset;

                    $thisfile_id3v2['padding']['length'] = strlen($framedata);

                    $thisfile_id3v2['padding']['valid'] = true;

                    for($i = 0; $i < $thisfile_id3v2['padding']['length']; $i ++)

                    {

                        if ($framedata{$i} != "\x00")

                        {

                            $thisfile_id3v2['padding']['valid'] = false;

                            $thisfile_id3v2['padding']['errorpos'] = $thisfile_id3v2['padding']['start'] + $i;

                            $ThisFileInfo['warning'][] = 'Invalid ID3v2 padding found at offset ' . $thisfile_id3v2['padding']['errorpos'] . ' (the remaining ' . ($thisfile_id3v2['padding']['length'] - $i) . ' bytes are considered invalid)';

                            break;

                        }

                    }

                    break; // skip rest of ID3v2 header
                }

                if ($id3v2_majorversion == 2)

                {

                    // Frame ID  $xx xx xx (three characters)
                    // Size      $xx xx xx (24-bit integer)
                    // Flags     $xx xx
                    



                    $frame_header = substr($framedata, 0, 6); // take next 6 bytes for header
                    $framedata = substr($framedata, 6); // and leave the rest in $framedata
                    $frame_name = substr($frame_header, 0, 3);

                    $frame_size = getid3_lib :: BigEndian2Int(substr($frame_header, 3, 3), 0);

                    $frame_flags = 0; // not used for anything in ID3v2.2, just set to avoid E_NOTICEs
                



                }

                elseif ($id3v2_majorversion > 2)

                {

                    

                    // Frame ID  $xx xx xx xx (four characters)
                    // Size      $xx xx xx xx (32-bit integer in v2.3, 28-bit synchsafe in v2.4+)
                    // Flags     $xx xx
                    



                    $frame_header = substr($framedata, 0, 10); // take next 10 bytes for header
                    $framedata = substr($framedata, 10); // and leave the rest in $framedata
                    



                    $frame_name = substr($frame_header, 0, 4);

                    if ($id3v2_majorversion == 3)

                    {

                        $frame_size = getid3_lib :: BigEndian2Int(substr($frame_header, 4, 4), 0); // 32-bit integer
                    }

                    else

                    { // ID3v2.4+
                        $frame_size = getid3_lib :: BigEndian2Int(substr($frame_header, 4, 4), 1); // 32-bit synchsafe integer (28-bit value)
                    }

                    

                    if ($frame_size < (strlen($framedata) + 4))

                    {

                        $nextFrameID = substr($framedata, $frame_size, 4);

                        if ($this->IsValidID3v2FrameName($nextFrameID, $id3v2_majorversion))

                        {

                            // next frame is OK
                        }

                        elseif (($frame_name == "\x00" . 'MP3') || ($frame_name == "\x00\x00" . 'MP') || ($frame_name == ' MP3') || ($frame_name == 'MP3e'))

                        {

                            // MP3ext known broken frames - "ok" for the purposes of this test
                        }

                        elseif (($id3v2_majorversion == 4) && ($this->IsValidID3v2FrameName(substr($framedata, getid3_lib :: BigEndian2Int(substr($frame_header, 4, 4), 0), 4), 3)))

                        {

                            $ThisFileInfo['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';

                            $id3v2_majorversion = 3;

                            $frame_size = getid3_lib :: BigEndian2Int(substr($frame_header, 4, 4), 0); // 32-bit integer
                        }

                    }

                    

                    $frame_flags = getid3_lib :: BigEndian2Int(substr($frame_header, 8, 2));

                }

                

                if ((($id3v2_majorversion == 2) && ($frame_name == "\x00\x00\x00")) || ($frame_name == "\x00\x00\x00\x00"))

                {

                    // padding encountered
                    



                    $thisfile_id3v2['padding']['start'] = $framedataoffset;

                    $thisfile_id3v2['padding']['length'] = strlen($framedata);

                    $thisfile_id3v2['padding']['valid'] = true;

                    for($i = 0; $i < $thisfile_id3v2['padding']['length']; $i ++)

                    {

                        if ($framedata{$i} != "\x00")

                        {

                            $thisfile_id3v2['padding']['valid'] = false;

                            $thisfile_id3v2['padding']['errorpos'] = $thisfile_id3v2['padding']['start'] + $i;

                            $ThisFileInfo['warning'][] = 'Invalid ID3v2 padding found at offset ' . $thisfile_id3v2['padding']['errorpos'] . ' (the remaining ' . ($thisfile_id3v2['padding']['length'] - $i) . ' bytes are considered invalid)';

                            break;

                        }

                    }

                    break; // skip rest of ID3v2 header
                }

                

                if ($frame_name == 'COM ')

                {

                    $ThisFileInfo['warning'][] = 'error parsing "' . $frame_name . '" (' . $framedataoffset . ' bytes into the ID3v2.' . $id3v2_majorversion . ' tag). (ERROR: IsValidID3v2FrameName("' . str_replace("\x00", ' ', $frame_name) . '", ' . $id3v2_majorversion . '))). [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)]';

                    $frame_name = 'COMM';

                }

                if (($frame_size <= strlen($framedata)) && ($this->IsValidID3v2FrameName($frame_name, $id3v2_majorversion)))

                {

                    

                    unset($parsedFrame);

                    $parsedFrame['frame_name'] = $frame_name;

                    $parsedFrame['frame_flags_raw'] = $frame_flags;

                    $parsedFrame['data'] = substr($framedata, 0, $frame_size);

                    $parsedFrame['datalength'] = getid3_lib :: CastAsInt($frame_size);

                    $parsedFrame['dataoffset'] = $framedataoffset;

                    

                    $this->ParseID3v2Frame($parsedFrame, $ThisFileInfo);

                    $thisfile_id3v2[$frame_name][] = $parsedFrame;

                    

                    $framedata = substr($framedata, $frame_size);

                

                }

                else

                { // invalid frame length or FrameID
                    



                    if ($frame_size <= strlen($framedata))

                    {

                        

                        if ($this->IsValidID3v2FrameName(substr($framedata, $frame_size, 4), $id3v2_majorversion))

                        {

                            

                            // next frame is valid, just skip the current frame
                            $framedata = substr($framedata, $frame_size);

                            $ThisFileInfo['warning'][] = 'Next ID3v2 frame is valid, skipping current frame.';

                        

                        }

                        else

                        {

                            

                            // next frame is invalid too, abort processing
                            //unset($framedata);
                            $framedata = null;

                            $ThisFileInfo['error'][] = 'Next ID3v2 frame is also invalid, aborting processing.';

                        

                        }

                    

                    }

                    elseif ($frame_size == strlen($framedata))

                    {

                        

                        // this is the last frame, just skip
                        $ThisFileInfo['warning'][] = 'This was the last ID3v2 frame.';

                    

                    }

                    else

                    {

                        

                        // next frame is invalid too, abort processing
                        //unset($framedata);
                        $framedata = null;

                        $ThisFileInfo['warning'][] = 'Invalid ID3v2 frame size, aborting.';

                    

                    }

                    if (! $this->IsValidID3v2FrameName($frame_name, $id3v2_majorversion))

                    {

                        

                        switch ($frame_name)

                        {

                            case "\x00\x00" . 'MP' :

                            case "\x00" . 'MP3' :

                            case ' MP3' :

                            case 'MP3e' :

                            case "\x00" . 'MP' :

                            case ' MP' :

                            case 'MP3' :

                                $ThisFileInfo['warning'][] = 'error parsing "' . $frame_name . '" (' . $framedataoffset . ' bytes into the ID3v2.' . $id3v2_majorversion . ' tag). (ERROR: !IsValidID3v2FrameName("' . str_replace("\x00", ' ', $frame_name) . '", ' . $id3v2_majorversion . '))). [Note: this particular error has been known to happen with tags edited by "MP3ext (www.mutschler.de/mp3ext/)"]';

                                break;

                            

                            default :

                                $ThisFileInfo['warning'][] = 'error parsing "' . $frame_name . '" (' . $framedataoffset . ' bytes into the ID3v2.' . $id3v2_majorversion . ' tag). (ERROR: !IsValidID3v2FrameName("' . str_replace("\x00", ' ', $frame_name) . '", ' . $id3v2_majorversion . '))).';

                                break;

                        }

                    

                    }

                    elseif ($frame_size > strlen($framedata))

                    {

                        

                        $ThisFileInfo['error'][] = 'error parsing "' . $frame_name . '" (' . $framedataoffset . ' bytes into the ID3v2.' . $id3v2_majorversion . ' tag). (ERROR: $frame_size (' . $frame_size . ') > strlen($framedata) (' . strlen($framedata) . ')).';

                    

                    }

                    else

                    {

                        

                        $ThisFileInfo['error'][] = 'error parsing "' . $frame_name . '" (' . $framedataoffset . ' bytes into the ID3v2.' . $id3v2_majorversion . ' tag).';

                    

                    }

                

                }

                $framedataoffset += ($frame_size + $this->ID3v2HeaderLength($id3v2_majorversion));

            

            }

        

        }

        

        //    Footer
        



        //    The footer is a copy of the header, but with a different identifier.
        //        ID3v2 identifier           "3DI"
        //        ID3v2 version              $04 00
        //        ID3v2 flags                %abcd0000
        //        ID3v2 size             4 * %0xxxxxxx
        



        if (isset($thisfile_id3v2_flags['isfooter']) && $thisfile_id3v2_flags['isfooter'])

        {

            $footer = fread($fd, 10);

            if (substr($footer, 0, 3) == '3DI')

            {

                $thisfile_id3v2['footer'] = true;

                $thisfile_id3v2['majorversion_footer'] = ord($footer{3});

                $thisfile_id3v2['minorversion_footer'] = ord($footer{4});

            }

            if ($thisfile_id3v2['majorversion_footer'] <= 4)

            {

                $id3_flags = ord(substr($footer{5}));

                $thisfile_id3v2_flags['unsynch_footer'] = (bool) ($id3_flags & 0x80);

                $thisfile_id3v2_flags['extfoot_footer'] = (bool) ($id3_flags & 0x40);

                $thisfile_id3v2_flags['experim_footer'] = (bool) ($id3_flags & 0x20);

                $thisfile_id3v2_flags['isfooter_footer'] = (bool) ($id3_flags & 0x10);

                

                $thisfile_id3v2['footerlength'] = getid3_lib :: BigEndian2Int(substr($footer, 6, 4), 1);

            }

        } // end footer
        



        if (isset($thisfile_id3v2['comments']['genre']))

        {

            foreach ($thisfile_id3v2['comments']['genre'] as $key => $value)

            {

                unset($thisfile_id3v2['comments']['genre'][$key]);

                $thisfile_id3v2['comments'] = getid3_lib :: array_merge_noclobber($thisfile_id3v2['comments'], $this->ParseID3v2GenreString($value));

            }

        }

        

        if (isset($thisfile_id3v2['comments']['track']))

        {

            foreach ($thisfile_id3v2['comments']['track'] as $key => $value)

            {

                if (strstr($value, '/'))

                {

                    list($thisfile_id3v2['comments']['tracknum'][$key], $thisfile_id3v2['comments']['totaltracks'][$key]) = explode('/', $thisfile_id3v2['comments']['track'][$key]);

                }

            }

        }

        

        if (! isset($thisfile_id3v2['comments']['year']) && ereg('^([0-9]{4})', trim(@$thisfile_id3v2['comments']['recording_time'][0]), $matches))

        {

            $thisfile_id3v2['comments']['year'] = array($matches[1]);

        }

        

        // Set avdataoffset
        $ThisFileInfo['avdataoffset'] = $thisfile_id3v2['headerlength'];

        if (isset($thisfile_id3v2['footer']))

        {

            $ThisFileInfo['avdataoffset'] += 10;

        }

        

        return true;

    }



    function ParseID3v2GenreString($genrestring)

    {

        // Parse genres into arrays of genreName and genreID
        // ID3v2.2.x, ID3v2.3.x: '(21)' or '(4)Eurodisco' or '(51)(39)' or '(55)((I think...)'
        // ID3v2.4.x: '21' $00 'Eurodisco' $00
        



        $genrestring = trim($genrestring);

        $returnarray = array();

        if (strpos($genrestring, "\x00") !== false)

        {

            $unprocessed = trim($genrestring); // trailing nulls will cause an infinite loop.
            $genrestring = '';

            while (strpos($unprocessed, "\x00") !== false)

            {

                // convert null-seperated v2.4-format into v2.3 ()-seperated format
                $endpos = strpos($unprocessed, "\x00");

                $genrestring .= '(' . substr($unprocessed, 0, $endpos) . ')';

                $unprocessed = substr($unprocessed, $endpos + 1);

            }

            unset($unprocessed);

        }

        if (getid3_id3v1 :: LookupGenreID($genrestring))

        {

            

            $returnarray['genre'][] = $genrestring;

        

        }

        else

        {

            

            while (strpos($genrestring, '(') !== false)

            {

                

                $startpos = strpos($genrestring, '(');

                $endpos = strpos($genrestring, ')');

                if (substr($genrestring, $startpos + 1, 1) == '(')

                {

                    $genrestring = substr($genrestring, 0, $startpos) . substr($genrestring, $startpos + 1);

                    $endpos --;

                }

                $element = substr($genrestring, $startpos + 1, $endpos - ($startpos + 1));

                $genrestring = substr($genrestring, 0, $startpos) . substr($genrestring, $endpos + 1);

                if (getid3_id3v1 :: LookupGenreName($element))

                { // $element is a valid genre id/abbreviation
                    



                    if (empty($returnarray['genre']) || ! in_array(getid3_id3v1 :: LookupGenreName($element), $returnarray['genre']))

                    { // avoid duplicate entires
                        $returnarray['genre'][] = getid3_id3v1 :: LookupGenreName($element);

                    }

                

                }

                else

                {

                    

                    if (empty($returnarray['genre']) || ! in_array($element, $returnarray['genre']))

                    { // avoid duplicate entires
                        $returnarray['genre'][] = $element;

                    }

                

                }

            }

        }

        if ($genrestring)

        {

            if (empty($returnarray['genre']) || ! in_array($genrestring, $returnarray['genre']))

            { // avoid duplicate entires
                $returnarray['genre'][] = $genrestring;

            }

        }

        

        return $returnarray;

    }



    function ParseID3v2Frame(&$parsedFrame, &$ThisFileInfo)

    {

        

        // shortcuts
        $id3v2_majorversion = $ThisFileInfo['id3v2']['majorversion'];

        

        $parsedFrame['framenamelong'] = $this->FrameNameLongLookup($parsedFrame['frame_name']);

        if (empty($parsedFrame['framenamelong']))

        {

            unset($parsedFrame['framenamelong']);

        }

        $parsedFrame['framenameshort'] = $this->FrameNameShortLookup($parsedFrame['frame_name']);

        if (empty($parsedFrame['framenameshort']))

        {

            unset($parsedFrame['framenameshort']);

        }

        

        if ($id3v2_majorversion >= 3)

        { // frame flags are not part of the ID3v2.2 standard
            if ($id3v2_majorversion == 3)

            {

                //    Frame Header Flags
                //    %abc00000 %ijk00000
                $parsedFrame['flags']['TagAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x8000); // a - Tag alter preservation
                $parsedFrame['flags']['FileAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x4000); // b - File alter preservation
                $parsedFrame['flags']['ReadOnly'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x2000); // c - Read only
                $parsedFrame['flags']['compression'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0080); // i - Compression
                $parsedFrame['flags']['Encryption'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0040); // j - Encryption
                $parsedFrame['flags']['GroupingIdentity'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0020); // k - Grouping identity
            



            }

            elseif ($id3v2_majorversion == 4)

            {

                //    Frame Header Flags
                //    %0abc0000 %0h00kmnp
                $parsedFrame['flags']['TagAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x4000); // a - Tag alter preservation
                $parsedFrame['flags']['FileAlterPreservation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x2000); // b - File alter preservation
                $parsedFrame['flags']['ReadOnly'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x1000); // c - Read only
                $parsedFrame['flags']['GroupingIdentity'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0040); // h - Grouping identity
                $parsedFrame['flags']['compression'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0008); // k - Compression
                $parsedFrame['flags']['Encryption'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0004); // m - Encryption
                $parsedFrame['flags']['Unsynchronisation'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0002); // n - Unsynchronisation
                $parsedFrame['flags']['DataLengthIndicator'] = (bool) ($parsedFrame['frame_flags_raw'] & 0x0001); // p - Data length indicator
                



                // Frame-level de-unsynchronisation - ID3v2.4
                if ($parsedFrame['flags']['Unsynchronisation'])

                {

                    $parsedFrame['data'] = $this->DeUnsynchronise($parsedFrame['data']);

                }

            }

            

            //    Frame-level de-compression
            if ($parsedFrame['flags']['compression'])

            {

                $parsedFrame['decompressed_size'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 0, 4));

                if (! function_exists('gzuncompress'))

                {

                    $ThisFileInfo['warning'][] = 'gzuncompress() support required to decompress ID3v2 frame "' . $parsedFrame['frame_name'] . '"';

                }

                elseif ($decompresseddata = @gzuncompress(substr($parsedFrame['data'], 4)))

                {

                    $parsedFrame['data'] = $decompresseddata;

                }

                else

                {

                    $ThisFileInfo['warning'][] = 'gzuncompress() failed on compressed contents of ID3v2 frame "' . $parsedFrame['frame_name'] . '"';

                }

            }

        }

        

        if (isset($parsedFrame['datalength']) && ($parsedFrame['datalength'] == 0))

        {

            

            $warning = 'Frame "' . $parsedFrame['frame_name'] . '" at offset ' . $parsedFrame['dataoffset'] . ' has no data portion';

            switch ($parsedFrame['frame_name'])

            {

                case 'WCOM' :

                    $warning .= ' (this is known to happen with files tagged by RioPort)';

                    break;

                

                default :

                    break;

            }

            $ThisFileInfo['warning'][] = $warning;

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'UFID')) || // 4.1   UFID Unique file identifier
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'UFI')))

        { // 4.1   UFI  Unique file identifier
            //   There may be more than one 'UFID' frame in a tag,
            //   but only one with the same 'Owner identifier'.
            // <Header for 'Unique file identifier', ID: 'UFID'>
            // Owner identifier        <text string> $00
            // Identifier              <up to 64 bytes binary data>
            



            $frame_terminatorpos = strpos($parsedFrame['data'], "\x00");

            $frame_idstring = substr($parsedFrame['data'], 0, $frame_terminatorpos);

            $parsedFrame['ownerid'] = $frame_idstring;

            $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen("\x00"));

            unset($parsedFrame['data']);

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'TXXX')) || // 4.2.2 TXXX User defined text information frame
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'TXX')))

        { // 4.2.2 TXX  User defined text information frame
            //   There may be more than one 'TXXX' frame in each tag,
            //   but only one with the same description.
            // <Header for 'User defined text information frame', ID: 'TXXX'>
            // Text encoding     $xx
            // Description       <text string according to encoding> $00 (00)
            // Value             <text string according to encoding>
            



            $frame_offset = 0;

            $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            

            if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3)))

            {

                $ThisFileInfo['warning'][] = 'Invalid text encoding byte (' . $frame_textencoding . ') in frame "' . $parsedFrame['frame_name'] . '" - defaulting to ISO-8859-1 encoding';

            }

            $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);

            if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0)

            {

                $frame_terminatorpos ++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
            }

            $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);

            if (ord($frame_description) === 0)

            {

                $frame_description = '';

            }

            $parsedFrame['encodingid'] = $frame_textencoding;

            $parsedFrame['encoding'] = $this->TextEncodingNameLookup($frame_textencoding);

            

            $parsedFrame['description'] = $frame_description;

            $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));

            if (! empty($parsedFrame['framenameshort']) && ! empty($parsedFrame['data']))

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = trim(getid3_lib :: iconv_fallback($parsedFrame['encoding'], $ThisFileInfo['id3v2']['encoding'], $parsedFrame['data']));

            }

            unset($parsedFrame['data']);

        

        }

        elseif ($parsedFrame['frame_name']{0} == 'T')

        { // 4.2. T??[?] Text information frame
            //   There may only be one text information frame of its kind in an tag.
            // <Header for 'Text information frame', ID: 'T000' - 'TZZZ',
            // excluding 'TXXX' described in 4.2.6.>
            // Text encoding                $xx
            // Information                  <text string(s) according to encoding>
            



            $frame_offset = 0;

            $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3)))

            {

                $ThisFileInfo['warning'][] = 'Invalid text encoding byte (' . $frame_textencoding . ') in frame "' . $parsedFrame['frame_name'] . '" - defaulting to ISO-8859-1 encoding';

            }

            

            $parsedFrame['data'] = (string) substr($parsedFrame['data'], $frame_offset);

            

            $parsedFrame['encodingid'] = $frame_textencoding;

            $parsedFrame['encoding'] = $this->TextEncodingNameLookup($frame_textencoding);

            

            if (! empty($parsedFrame['framenameshort']) && ! empty($parsedFrame['data']))

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib :: iconv_fallback($parsedFrame['encoding'], $ThisFileInfo['id3v2']['encoding'], $parsedFrame['data']);

            }

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'WXXX')) || // 4.3.2 WXXX User defined URL link frame
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'WXX')))

        { // 4.3.2 WXX  User defined URL link frame
            //   There may be more than one 'WXXX' frame in each tag,
            //   but only one with the same description
            // <Header for 'User defined URL link frame', ID: 'WXXX'>
            // Text encoding     $xx
            // Description       <text string according to encoding> $00 (00)
            // URL               <text string>
            



            $frame_offset = 0;

            $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3)))

            {

                $ThisFileInfo['warning'][] = 'Invalid text encoding byte (' . $frame_textencoding . ') in frame "' . $parsedFrame['frame_name'] . '" - defaulting to ISO-8859-1 encoding';

            }

            $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding), $frame_offset);

            if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0)

            {

                $frame_terminatorpos ++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
            }

            $frame_description = substr($parsedFrame['data'], $frame_offset, $frame_terminatorpos - $frame_offset);

            

            if (ord($frame_description) === 0)

            {

                $frame_description = '';

            }

            $parsedFrame['data'] = substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)));

            

            $frame_terminatorpos = strpos($parsedFrame['data'], $this->TextEncodingTerminatorLookup($frame_textencoding));

            if (ord(substr($parsedFrame['data'], $frame_terminatorpos + strlen($this->TextEncodingTerminatorLookup($frame_textencoding)), 1)) === 0)

            {

                $frame_terminatorpos ++; // strpos() fooled because 2nd byte of Unicode chars are often 0x00
            }

            if ($frame_terminatorpos)

            {

                // there are null bytes after the data - this is not according to spec
                // only use data up to first null byte
                $frame_urldata = (string) substr($parsedFrame['data'], 0, $frame_terminatorpos);

            }

            else

            {

                // no null bytes following data, just use all data
                $frame_urldata = (string) $parsedFrame['data'];

            }

            

            $parsedFrame['encodingid'] = $frame_textencoding;

            $parsedFrame['encoding'] = $this->TextEncodingNameLookup($frame_textencoding);

            

            $parsedFrame['url'] = $frame_urldata;

            $parsedFrame['description'] = $frame_description;

            if (! empty($parsedFrame['framenameshort']) && $parsedFrame['url'])

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib :: iconv_fallback($parsedFrame['encoding'], $ThisFileInfo['id3v2']['encoding'], $parsedFrame['url']);

            }

            unset($parsedFrame['data']);

        

        }

        elseif ($parsedFrame['frame_name']{0} == 'W')

        { // 4.3. W??? URL link frames
            //   There may only be one URL link frame of its kind in a tag,
            //   except when stated otherwise in the frame description
            // <Header for 'URL link frame', ID: 'W000' - 'WZZZ', excluding 'WXXX'
            // described in 4.3.2.>
            // URL              <text string>
            



            $parsedFrame['url'] = trim($parsedFrame['data']);

            if (! empty($parsedFrame['framenameshort']) && $parsedFrame['url'])

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = $parsedFrame['url'];

            }

            unset($parsedFrame['data']);

        

        }

        elseif ((($id3v2_majorversion == 3) && ($parsedFrame['frame_name'] == 'IPLS')) || // 4.4  IPLS Involved people list (ID3v2.3 only)
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'IPL')))

        { // 4.4  IPL  Involved people list (ID3v2.2 only)
            //   There may only be one 'IPL' frame in each tag
            // <Header for 'User defined URL link frame', ID: 'IPL'>
            // Text encoding     $xx
            // People list strings    <textstrings>
            



            $frame_offset = 0;

            $frame_textencoding = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            if ((($id3v2_majorversion <= 3) && ($frame_textencoding > 1)) || (($id3v2_majorversion == 4) && ($frame_textencoding > 3)))

            {

                $ThisFileInfo['warning'][] = 'Invalid text encoding byte (' . $frame_textencoding . ') in frame "' . $parsedFrame['frame_name'] . '" - defaulting to ISO-8859-1 encoding';

            }

            $parsedFrame['encodingid'] = $frame_textencoding;

            $parsedFrame['encoding'] = $this->TextEncodingNameLookup($parsedFrame['encodingid']);

            

            $parsedFrame['data'] = (string) substr($parsedFrame['data'], $frame_offset);

            if (! empty($parsedFrame['framenameshort']) && ! empty($parsedFrame['data']))

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = getid3_lib :: iconv_fallback($parsedFrame['encoding'], $ThisFileInfo['id3v2']['encoding'], $parsedFrame['data']);

            }

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'MCDI')) || // 4.4   MCDI Music CD identifier
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'MCI')))

        { // 4.5   MCI  Music CD identifier
            //   There may only be one 'MCDI' frame in each tag
            // <Header for 'Music CD identifier', ID: 'MCDI'>
            // CD TOC                <binary data>
            



            if (! empty($parsedFrame['framenameshort']) && ! empty($parsedFrame['data']))

            {

                $ThisFileInfo['id3v2']['comments'][$parsedFrame['framenameshort']][] = $parsedFrame['data'];

            }

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'ETCO')) || // 4.5   ETCO Event timing codes
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'ETC')))

        { // 4.6   ETC  Event timing codes
            //   There may only be one 'ETCO' frame in each tag
            // <Header for 'Event timing codes', ID: 'ETCO'>
            // Time stamp format    $xx
            //   Where time stamp format is:
            // $01  (32-bit value) MPEG frames from beginning of file
            // $02  (32-bit value) milliseconds from beginning of file
            //   Followed by a list of key events in the following format:
            // Type of event   $xx
            // Time stamp      $xx (xx ...)
            //   The 'Time stamp' is set to zero if directly at the beginning of the sound
            //   or after the previous event. All events MUST be sorted in chronological order.
            



            $frame_offset = 0;

            $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            

            while ($frame_offset < strlen($parsedFrame['data']))

            {

                $parsedFrame['typeid'] = substr($parsedFrame['data'], $frame_offset ++, 1);

                $parsedFrame['type'] = $this->ETCOEventLookup($parsedFrame['typeid']);

                $parsedFrame['timestamp'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));

                $frame_offset += 4;

            }

            unset($parsedFrame['data']);

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'MLLT')) || // 4.6   MLLT MPEG location lookup table
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'MLL')))

        { // 4.7   MLL MPEG location lookup table
            //   There may only be one 'MLLT' frame in each tag
            // <Header for 'Location lookup table', ID: 'MLLT'>
            // MPEG frames between reference  $xx xx
            // Bytes between reference        $xx xx xx
            // Milliseconds between reference $xx xx xx
            // Bits for bytes deviation       $xx
            // Bits for milliseconds dev.     $xx
            //   Then for every reference the following data is included;
            // Deviation in bytes         %xxx....
            // Deviation in milliseconds  %xxx....
            



            $frame_offset = 0;

            $parsedFrame['framesbetweenreferences'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 0, 2));

            $parsedFrame['bytesbetweenreferences'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 2, 3));

            $parsedFrame['msbetweenreferences'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 5, 3));

            $parsedFrame['bitsforbytesdeviation'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 8, 1));

            $parsedFrame['bitsformsdeviation'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], 9, 1));

            $parsedFrame['data'] = substr($parsedFrame['data'], 10);

            while ($frame_offset < strlen($parsedFrame['data']))

            {

                $deviationbitstream .= getid3_lib :: BigEndian2Bin(substr($parsedFrame['data'], $frame_offset ++, 1));

            }

            $reference_counter = 0;

            while (strlen($deviationbitstream) > 0)

            {

                $parsedFrame[$reference_counter]['bytedeviation'] = bindec(substr($deviationbitstream, 0, $parsedFrame['bitsforbytesdeviation']));

                $parsedFrame[$reference_counter]['msdeviation'] = bindec(substr($deviationbitstream, $parsedFrame['bitsforbytesdeviation'], $parsedFrame['bitsformsdeviation']));

                $deviationbitstream = substr($deviationbitstream, $parsedFrame['bitsforbytesdeviation'] + $parsedFrame['bitsformsdeviation']);

                $reference_counter ++;

            }

            unset($parsedFrame['data']);

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'SYTC')) || // 4.7   SYTC Synchronised tempo codes
(($id3v2_majorversion == 2) && ($parsedFrame['frame_name'] == 'STC')))

        { // 4.8   STC  Synchronised tempo codes
            //   There may only be one 'SYTC' frame in each tag
            // <Header for 'Synchronised tempo codes', ID: 'SYTC'>
            // Time stamp format   $xx
            // Tempo data          <binary data>
            //   Where time stamp format is:
            // $01  (32-bit value) MPEG frames from beginning of file
            // $02  (32-bit value) milliseconds from beginning of file
            



            $frame_offset = 0;

            $parsedFrame['timestampformat'] = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

            $timestamp_counter = 0;

            while ($frame_offset < strlen($parsedFrame['data']))

            {

                $parsedFrame[$timestamp_counter]['tempo'] = ord(substr($parsedFrame['data'], $frame_offset ++, 1));

                if ($parsedFrame[$timestamp_counter]['tempo'] == 255)

                {

                    $parsedFrame[$timestamp_counter]['tempo'] += ord(substr($parsedFrame['data'], $frame_offset ++, 1));

                }

                $parsedFrame[$timestamp_counter]['timestamp'] = getid3_lib :: BigEndian2Int(substr($parsedFrame['data'], $frame_offset, 4));

                $frame_offset += 4;

                $timestamp_counter ++;

            }

            unset($parsedFrame['data']);

        

        }

        elseif ((($id3v2_majorversion >= 3) && ($parsedFrame['frame_name'] == 'USLT')) || // …

Large files files are truncated, but you can click here to view the full file