Public Member Functions

getid3_lyrics3 Class Reference

getID3() by James Heinrich <info@getid3.org> // More...

Public Member Functions

 getid3_lyrics3 (&$fd, &$ThisFileInfo)
 getLyrics3Data (&$ThisFileInfo, &$fd, $endoffset, $version, $length)
 Lyrics3Timestamp2Seconds ($rawtimestamp)
 Lyrics3LyricsTimestampParse (&$Lyrics3data)
 IntString2Bool ($char)

Detailed Description

getID3() by James Heinrich <info@getid3.org> //

//

Definition at line 17 of file module.tag.lyrics3.php.


Member Function Documentation

getid3_lyrics3::getid3_lyrics3 ( &$  fd,
&$  ThisFileInfo 
)

Definition at line 20 of file module.tag.lyrics3.php.

References getLyrics3Data(), and getid3_lib::IncludeDependency().

                                                      {
                // http://www.volweb.cz/str/tags.htm

                fseek($fd, (0 - 128 - 9 - 6), SEEK_END);          // end - ID3v1 - LYRICSEND - [Lyrics3size]
                $lyrics3_id3v1 = fread($fd, 128 + 9 + 6);
                $lyrics3lsz    = substr($lyrics3_id3v1,  0,   6); // Lyrics3size
                $lyrics3end    = substr($lyrics3_id3v1,  6,   9); // LYRICSEND or LYRICS200
                $id3v1tag      = substr($lyrics3_id3v1, 15, 128); // ID3v1

                if ($lyrics3end == 'LYRICSEND') {
                        // Lyrics3v1, ID3v1, no APE

                        $lyrics3size    = 5100;
                        $lyrics3offset  = $ThisFileInfo['filesize'] - 128 - $lyrics3size;
                        $lyrics3version = 1;

                } elseif ($lyrics3end == 'LYRICS200') {
                        // Lyrics3v2, ID3v1, no APE

                        // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200'
                        $lyrics3size    = $lyrics3lsz + 6 + strlen('LYRICS200');
                        $lyrics3offset  = $ThisFileInfo['filesize'] - 128 - $lyrics3size;
                        $lyrics3version = 2;

                } elseif (substr(strrev($lyrics3_id3v1), 0, 9) == strrev('LYRICSEND')) {
                        // Lyrics3v1, no ID3v1, no APE

                        $lyrics3size    = 5100;
                        $lyrics3offset  = $ThisFileInfo['filesize'] - $lyrics3size;
                        $lyrics3version = 1;
                        $lyrics3offset  = $ThisFileInfo['filesize'] - $lyrics3size;

                } elseif (substr(strrev($lyrics3_id3v1), 0, 9) == strrev('LYRICS200')) {

                        // Lyrics3v2, no ID3v1, no APE

                        $lyrics3size    = strrev(substr(strrev($lyrics3_id3v1), 9, 6)) + 6 + strlen('LYRICS200'); // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200'
                        $lyrics3offset  = $ThisFileInfo['filesize'] - $lyrics3size;
                        $lyrics3version = 2;

                } else {

                        if (isset($ThisFileInfo['ape']['tag_offset_start']) && ($ThisFileInfo['ape']['tag_offset_start'] > 15)) {

                                fseek($fd, $ThisFileInfo['ape']['tag_offset_start'] - 15, SEEK_SET);
                                $lyrics3lsz = fread($fd, 6);
                                $lyrics3end = fread($fd, 9);

                                if ($lyrics3end == 'LYRICSEND') {
                                        // Lyrics3v1, APE, maybe ID3v1

                                        $lyrics3size    = 5100;
                                        $lyrics3offset  = $ThisFileInfo['ape']['tag_offset_start'] - $lyrics3size;
                                        $ThisFileInfo['avdataend'] = $lyrics3offset;
                                        $lyrics3version = 1;
                                        $ThisFileInfo['warning'][] = 'APE tag located after Lyrics3, will probably break Lyrics3 compatability';

                                } elseif ($lyrics3end == 'LYRICS200') {
                                        // Lyrics3v2, APE, maybe ID3v1

                                        $lyrics3size    = $lyrics3lsz + 6 + strlen('LYRICS200'); // LSZ = lyrics + 'LYRICSBEGIN'; add 6-byte size field; add 'LYRICS200'
                                        $lyrics3offset  = $ThisFileInfo['ape']['tag_offset_start'] - $lyrics3size;
                                        $lyrics3version = 2;
                                        $ThisFileInfo['warning'][] = 'APE tag located after Lyrics3, will probably break Lyrics3 compatability';

                                }

                        }

                }

                if (isset($lyrics3offset)) {
                        $ThisFileInfo['avdataend'] = $lyrics3offset;
                        $this->getLyrics3Data($ThisFileInfo, $fd, $lyrics3offset, $lyrics3version, $lyrics3size);

                        if (!isset($ThisFileInfo['ape'])) {
                                $GETID3_ERRORARRAY = &$ThisFileInfo['warning'];
                                if (getid3_lib::IncludeDependency(GETID3_INCLUDEPATH.'module.tag.apetag.php', __FILE__, false)) {
                                        $tag = new getid3_apetag($fd, $ThisFileInfo, $ThisFileInfo['lyrics3']['tag_offset_start']);
                                }
                        }

                }

                return true;
        }

Here is the call graph for this function:

getid3_lyrics3::getLyrics3Data ( &$  ThisFileInfo,
&$  fd,
endoffset,
version,
length 
)

Definition at line 107 of file module.tag.lyrics3.php.

References IntString2Bool(), Lyrics3LyricsTimestampParse(), and Lyrics3Timestamp2Seconds().

Referenced by getid3_lyrics3().

                                                                                     {
                // http://www.volweb.cz/str/tags.htm

                fseek($fd, $endoffset, SEEK_SET);
                if ($length <= 0) {
                        return false;
                }
                $rawdata = fread($fd, $length);

                if (substr($rawdata, 0, 11) != 'LYRICSBEGIN') {
                        if (strpos($rawdata, 'LYRICSBEGIN') !== false) {

                                $ThisFileInfo['warning'][] = '"LYRICSBEGIN" expected at '.$endoffset.' but actually found at '.($endoffset + strpos($rawdata, 'LYRICSBEGIN')).' - this is invalid for Lyrics3 v'.$version;
                                $ThisFileInfo['avdataend'] = $endoffset + strpos($rawdata, 'LYRICSBEGIN');
                                $ParsedLyrics3['tag_offset_start'] = $ThisFileInfo['avdataend'];
                                $rawdata = substr($rawdata, strpos($rawdata, 'LYRICSBEGIN'));
                                $length = strlen($rawdata);

                        } else {

                                $ThisFileInfo['error'][] = '"LYRICSBEGIN" expected at '.$endoffset.' but found "'.substr($rawdata, 0, 11).'" instead';
                                return false;

                        }

                }

                $ParsedLyrics3['raw']['lyrics3version'] = $version;
                $ParsedLyrics3['raw']['lyrics3tagsize'] = $length;
                $ParsedLyrics3['tag_offset_start']      = $endoffset;
                $ParsedLyrics3['tag_offset_end']        = $endoffset + $length;

                switch ($version) {

                        case 1:
                                if (substr($rawdata, strlen($rawdata) - 9, 9) == 'LYRICSEND') {
                                        $ParsedLyrics3['raw']['LYR'] = trim(substr($rawdata, 11, strlen($rawdata) - 11 - 9));
                                        $this->Lyrics3LyricsTimestampParse($ParsedLyrics3);
                                } else {
                                        $ThisFileInfo['error'][] = '"LYRICSEND" expected at '.(ftell($fd) - 11 + $length - 9).' but found "'.substr($rawdata, strlen($rawdata) - 9, 9).'" instead';
                                        return false;
                                }
                                break;

                        case 2:
                                if (substr($rawdata, strlen($rawdata) - 9, 9) == 'LYRICS200') {
                                        $ParsedLyrics3['raw']['unparsed'] = substr($rawdata, 11, strlen($rawdata) - 11 - 9 - 6); // LYRICSBEGIN + LYRICS200 + LSZ
                                        $rawdata = $ParsedLyrics3['raw']['unparsed'];
                                        while (strlen($rawdata) > 0) {
                                                $fieldname = substr($rawdata, 0, 3);
                                                $fieldsize = (int) substr($rawdata, 3, 5);
                                                $ParsedLyrics3['raw'][$fieldname] = substr($rawdata, 8, $fieldsize);
                                                $rawdata = substr($rawdata, 3 + 5 + $fieldsize);
                                        }

                                        if (isset($ParsedLyrics3['raw']['IND'])) {
                                                $i = 0;
                                                $flagnames = array('lyrics', 'timestamps', 'inhibitrandom');
                                                foreach ($flagnames as $flagname) {
                                                        if (strlen($ParsedLyrics3['raw']['IND']) > ++$i) {
                                                                $ParsedLyrics3['flags'][$flagname] = $this->IntString2Bool(substr($ParsedLyrics3['raw']['IND'], $i, 1));
                                                        }
                                                }
                                        }

                                        $fieldnametranslation = array('ETT'=>'title', 'EAR'=>'artist', 'EAL'=>'album', 'INF'=>'comment', 'AUT'=>'author');
                                        foreach ($fieldnametranslation as $key => $value) {
                                                if (isset($ParsedLyrics3['raw'][$key])) {
                                                        $ParsedLyrics3['comments'][$value][] = trim($ParsedLyrics3['raw'][$key]);
                                                }
                                        }

                                        if (isset($ParsedLyrics3['raw']['IMG'])) {
                                                $imagestrings = explode("\r\n", $ParsedLyrics3['raw']['IMG']);
                                                foreach ($imagestrings as $key => $imagestring) {
                                                        if (strpos($imagestring, '||') !== false) {
                                                                $imagearray = explode('||', $imagestring);
                                                                $ParsedLyrics3['images'][$key]['filename']     = $imagearray[0];
                                                                $ParsedLyrics3['images'][$key]['description']  = $imagearray[1];
                                                                $ParsedLyrics3['images'][$key]['timestamp']    = $this->Lyrics3Timestamp2Seconds($imagearray[2]);
                                                        }
                                                }
                                        }
                                        if (isset($ParsedLyrics3['raw']['LYR'])) {
                                                $this->Lyrics3LyricsTimestampParse($ParsedLyrics3);
                                        }
                                } else {
                                        $ThisFileInfo['error'][] = '"LYRICS200" expected at '.(ftell($fd) - 11 + $length - 9).' but found "'.substr($rawdata, strlen($rawdata) - 9, 9).'" instead';
                                        return false;
                                }
                                break;

                        default:
                                $ThisFileInfo['error'][] = 'Cannot process Lyrics3 version '.$version.' (only v1 and v2)';
                                return false;
                                break;
                }


                if (isset($ThisFileInfo['id3v1']['tag_offset_start']) && ($ThisFileInfo['id3v1']['tag_offset_start'] < $ParsedLyrics3['tag_offset_end'])) {
                        $ThisFileInfo['warning'][] = 'ID3v1 tag information ignored since it appears to be a false synch in Lyrics3 tag data';
                        unset($ThisFileInfo['id3v1']);
                        foreach ($ThisFileInfo['warning'] as $key => $value) {
                                if ($value == 'Some ID3v1 fields do not use NULL characters for padding') {
                                        unset($ThisFileInfo['warning'][$key]);
                                        sort($ThisFileInfo['warning']);
                                        break;
                                }
                        }
                }

                $ThisFileInfo['lyrics3'] = $ParsedLyrics3;

                return true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getid3_lyrics3::IntString2Bool ( char  ) 

Definition at line 260 of file module.tag.lyrics3.php.

Referenced by getLyrics3Data().

                                       {
                if ($char == '1') {
                        return true;
                } elseif ($char == '0') {
                        return false;
                }
                return null;
        }

Here is the caller graph for this function:

getid3_lyrics3::Lyrics3LyricsTimestampParse ( &$  Lyrics3data  ) 

Definition at line 230 of file module.tag.lyrics3.php.

References $timestamp, and Lyrics3Timestamp2Seconds().

Referenced by getLyrics3Data().

                                                            {
                $lyricsarray = explode("\r\n", $Lyrics3data['raw']['LYR']);
                foreach ($lyricsarray as $key => $lyricline) {
                        $regs = array();
                        unset($thislinetimestamps);
                        while (ereg('^(\\[[0-9]{2}:[0-9]{2}\\])', $lyricline, $regs)) {
                                $thislinetimestamps[] = $this->Lyrics3Timestamp2Seconds($regs[0]);
                                $lyricline = str_replace($regs[0], '', $lyricline);
                        }
                        $notimestamplyricsarray[$key] = $lyricline;
                        if (isset($thislinetimestamps) && is_array($thislinetimestamps)) {
                                sort($thislinetimestamps);
                                foreach ($thislinetimestamps as $timestampkey => $timestamp) {
                                        if (isset($Lyrics3data['synchedlyrics'][$timestamp])) {
                                                // timestamps only have a 1-second resolution, it's possible that multiple lines
                                                // could have the same timestamp, if so, append
                                                $Lyrics3data['synchedlyrics'][$timestamp] .= "\r\n".$lyricline;
                                        } else {
                                                $Lyrics3data['synchedlyrics'][$timestamp] = $lyricline;
                                        }
                                }
                        }
                }
                $Lyrics3data['unsynchedlyrics'] = implode("\r\n", $notimestamplyricsarray);
                if (isset($Lyrics3data['synchedlyrics']) && is_array($Lyrics3data['synchedlyrics'])) {
                        ksort($Lyrics3data['synchedlyrics']);
                }
                return true;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getid3_lyrics3::Lyrics3Timestamp2Seconds ( rawtimestamp  ) 

Definition at line 223 of file module.tag.lyrics3.php.

Referenced by getLyrics3Data(), and Lyrics3LyricsTimestampParse().

                                                         {
                if (ereg('^\\[([0-9]{2}):([0-9]{2})\\]$', $rawtimestamp, $regs)) {
                        return (int) (($regs[1] * 60) + $regs[2]);
                }
                return false;
        }

Here is the caller graph for this function:


The documentation for this class was generated from the following file: