wp/wp-includes/ID3/readme.txt
changeset 0 d970ebf37754
child 5 5e2f62d02dcd
equal deleted inserted replaced
-1:000000000000 0:d970ebf37754
       
     1 /////////////////////////////////////////////////////////////////
       
     2 /// getID3() by James Heinrich <info@getid3.org>               //
       
     3 //  available at http://getid3.sourceforge.net                 //
       
     4 //            or http://www.getid3.org                         //
       
     5 /////////////////////////////////////////////////////////////////
       
     6 
       
     7 *****************************************************************
       
     8 *****************************************************************
       
     9 
       
    10    getID3() is released under multiple licenses. You may choose
       
    11    from the following licenses, and use getID3 according to the
       
    12    terms of the license most suitable to your project.
       
    13 
       
    14 GNU GPL: https://gnu.org/licenses/gpl.html                   (v3)
       
    15          https://gnu.org/licenses/old-licenses/gpl-2.0.html  (v2)
       
    16          https://gnu.org/licenses/old-licenses/gpl-1.0.html  (v1)
       
    17 
       
    18 GNU LGPL: https://gnu.org/licenses/lgpl.html                 (v3)
       
    19 
       
    20 Mozilla MPL: http://www.mozilla.org/MPL/2.0/                 (v2)
       
    21 
       
    22 getID3 Commercial License: http://getid3.org/#gCL (payment required)
       
    23 
       
    24 *****************************************************************
       
    25 *****************************************************************
       
    26 Copies of each of the above licenses are included in the 'licenses'
       
    27 directory of the getID3 distribution.
       
    28 
       
    29 
       
    30        +---------------------------------------------+
       
    31        | If you want to donate, there is a link on   |
       
    32        | http://www.getid3.org for PayPal donations. |
       
    33        +---------------------------------------------+
       
    34 
       
    35 
       
    36 Quick Start
       
    37 ===========================================================================
       
    38 
       
    39 Q: How can I check that getID3() works on my server/files?
       
    40 A: Unzip getID3() to a directory, then access /demos/demo.browse.php
       
    41 
       
    42 
       
    43 
       
    44 Support
       
    45 ===========================================================================
       
    46 
       
    47 Q: I have a question, or I found a bug. What do I do?
       
    48 A: The preferred method of support requests and/or bug reports is the
       
    49    forum at http://support.getid3.org/
       
    50 
       
    51 
       
    52 
       
    53 Sourceforge Notification
       
    54 ===========================================================================
       
    55 
       
    56 It's highly recommended that you sign up for notification from
       
    57 Sourceforge for when new versions are released. Please visit:
       
    58 http://sourceforge.net/project/showfiles.php?group_id=55859
       
    59 and click the little "monitor package" icon/link.  If you're
       
    60 previously signed up for the mailing list, be aware that it has
       
    61 been discontinued, only the automated Sourceforge notification
       
    62 will be used from now on.
       
    63 
       
    64 
       
    65 
       
    66 What does getID3() do?
       
    67 ===========================================================================
       
    68 
       
    69 Reads & parses (to varying degrees):
       
    70 # tags:
       
    71   * APE (v1 and v2)
       
    72   * ID3v1 (& ID3v1.1)
       
    73   * ID3v2 (v2.4, v2.3, v2.2)
       
    74   * Lyrics3 (v1 & v2)
       
    75 
       
    76 # audio-lossy:
       
    77   * MP3/MP2/MP1
       
    78   * MPC / Musepack
       
    79   * Ogg (Vorbis, OggFLAC, Speex)
       
    80   * AAC / MP4
       
    81   * AC3
       
    82   * DTS
       
    83   * RealAudio
       
    84   * Speex
       
    85   * DSS
       
    86   * VQF
       
    87 
       
    88 # audio-lossless:
       
    89   * AIFF
       
    90   * AU
       
    91   * Bonk
       
    92   * CD-audio (*.cda)
       
    93   * FLAC
       
    94   * LA (Lossless Audio)
       
    95   * LiteWave
       
    96   * LPAC
       
    97   * MIDI
       
    98   * Monkey's Audio
       
    99   * OptimFROG
       
   100   * RKAU
       
   101   * Shorten
       
   102   * TTA
       
   103   * VOC
       
   104   * WAV (RIFF)
       
   105   * WavPack
       
   106 
       
   107 # audio-video:
       
   108   * ASF: ASF, Windows Media Audio (WMA), Windows Media Video (WMV)
       
   109   * AVI (RIFF)
       
   110   * Flash
       
   111   * Matroska (MKV)
       
   112   * MPEG-1 / MPEG-2
       
   113   * NSV (Nullsoft Streaming Video)
       
   114   * Quicktime (including MP4)
       
   115   * RealVideo
       
   116 
       
   117 # still image:
       
   118   * BMP
       
   119   * GIF
       
   120   * JPEG
       
   121   * PNG
       
   122   * TIFF
       
   123   * SWF (Flash)
       
   124   * PhotoCD
       
   125 
       
   126 # data:
       
   127   * ISO-9660 CD-ROM image (directory structure)
       
   128   * SZIP (limited support)
       
   129   * ZIP (directory structure)
       
   130   * TAR
       
   131   * CUE
       
   132 
       
   133 
       
   134 Writes:
       
   135   * ID3v1 (& ID3v1.1)
       
   136   * ID3v2 (v2.3 & v2.4)
       
   137   * VorbisComment on OggVorbis
       
   138   * VorbisComment on FLAC (not OggFLAC)
       
   139   * APE v2
       
   140   * Lyrics3 (delete only)
       
   141 
       
   142 
       
   143 
       
   144 Requirements
       
   145 ===========================================================================
       
   146 
       
   147 * PHP 4.2.0 up to 5.2.x for getID3() 1.7.x (and earlier)
       
   148 * PHP 5.0.5 (or higher) for getID3() 1.8.x (and up)
       
   149 * PHP 5.0.5 (or higher) for getID3() 2.0.x (and up)
       
   150 * at least 4MB memory for PHP. 8MB or more is highly recommended.
       
   151   12MB is required with all modules loaded.
       
   152 
       
   153 
       
   154 
       
   155 Usage
       
   156 ===========================================================================
       
   157 
       
   158 See /demos/demo.basic.php for a very basic use of getID3() with no
       
   159 fancy output, just scanning one file.
       
   160 
       
   161 See structure.txt for the returned data structure.
       
   162 
       
   163 *>  For an example of a complete directory-browsing,       <*
       
   164 *>  file-scanning implementation of getID3(), please run   <*
       
   165 *>  /demos/demo.browse.php                                 <*
       
   166 
       
   167 See /demos/demo.mysql.php for a sample recursive scanning code that
       
   168 scans every file in a given directory, and all sub-directories, stores
       
   169 the results in a database and allows various analysis / maintenance
       
   170 operations
       
   171 
       
   172 To analyze remote files over HTTP or FTP you need to copy the file
       
   173 locally first before running getID3(). Your code would look something
       
   174 like this:
       
   175 
       
   176 // Copy remote file locally to scan with getID3()
       
   177 $remotefilename = 'http://www.example.com/filename.mp3';
       
   178 if ($fp_remote = fopen($remotefilename, 'rb')) {
       
   179     $localtempfilename = tempnam('/tmp', 'getID3');
       
   180     if ($fp_local = fopen($localtempfilename, 'wb')) {
       
   181         while ($buffer = fread($fp_remote, 8192)) {
       
   182             fwrite($fp_local, $buffer);
       
   183         }
       
   184         fclose($fp_local);
       
   185 
       
   186 		// Initialize getID3 engine
       
   187 		$getID3 = new getID3;
       
   188 
       
   189 		$ThisFileInfo = $getID3->analyze($filename);
       
   190 
       
   191         // Delete temporary file
       
   192         unlink($localtempfilename);
       
   193     }
       
   194     fclose($fp_remote);
       
   195 }
       
   196 
       
   197 
       
   198 See /demos/demo.write.php for how to write tags.
       
   199 
       
   200 
       
   201 
       
   202 What does the returned data structure look like?
       
   203 ===========================================================================
       
   204 
       
   205 See structure.txt
       
   206 
       
   207 It is recommended that you look at the output of
       
   208 /demos/demo.browse.php scanning the file(s) you're interested in to
       
   209 confirm what data is actually returned for any particular filetype in
       
   210 general, and your files in particular, as the actual data returned
       
   211 may vary considerably depending on what information is available in
       
   212 the file itself.
       
   213 
       
   214 
       
   215 
       
   216 Notes
       
   217 ===========================================================================
       
   218 
       
   219 getID3() 1.x:
       
   220 If the format parser encounters a critical problem, it will return
       
   221 something in $fileinfo['error'], describing the encountered error. If
       
   222 a less critical error or notice is generated it will appear in
       
   223 $fileinfo['warning']. Both keys may contain more than one warning or
       
   224 error. If something is returned in ['error'] then the file was not
       
   225 correctly parsed and returned data may or may not be correct and/or
       
   226 complete. If something is returned in ['warning'] (and not ['error'])
       
   227 then the data that is returned is OK - usually getID3() is reporting
       
   228 errors in the file that have been worked around due to known bugs in
       
   229 other programs. Some warnings may indicate that the data that is
       
   230 returned is OK but that some data could not be extracted due to
       
   231 errors in the file.
       
   232 
       
   233 getID3() 2.x:
       
   234 See above except errors are thrown (so you will only get one error).
       
   235 
       
   236 
       
   237 
       
   238 Disclaimer
       
   239 ===========================================================================
       
   240 
       
   241 getID3() has been tested on many systems, on many types of files,
       
   242 under many operating systems, and is generally believe to be stable
       
   243 and safe. That being said, there is still the chance there is an
       
   244 undiscovered and/or unfixed bug that may potentially corrupt your
       
   245 file, especially within the writing functions. By using getID3() you
       
   246 agree that it's not my fault if any of your files are corrupted.
       
   247 In fact, I'm not liable for anything :)
       
   248 
       
   249 
       
   250 
       
   251 License
       
   252 ===========================================================================
       
   253 
       
   254 GNU General Public License - see license.txt
       
   255 
       
   256 This program is free software; you can redistribute it and/or
       
   257 modify it under the terms of the GNU General Public License
       
   258 as published by the Free Software Foundation; either version 2
       
   259 of the License, or (at your option) any later version.
       
   260 
       
   261 This program is distributed in the hope that it will be useful,
       
   262 but WITHOUT ANY WARRANTY; without even the implied warranty of
       
   263 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
       
   264 GNU General Public License for more details.
       
   265 
       
   266 You should have received a copy of the GNU General Public License
       
   267 along with this program; if not, write to:
       
   268 Free Software Foundation, Inc.
       
   269 59 Temple Place - Suite 330
       
   270 Boston, MA  02111-1307, USA.
       
   271 
       
   272 FAQ:
       
   273 Q: Can I use getID3() in my program? Do I need a commercial license?
       
   274 A: You're generally free to use getID3 however you see fit. The only
       
   275    case in which you would require a commercial license is if you're
       
   276    selling your closed-source program that integrates getID3. If you
       
   277    sell your program including a copy of getID3, that's fine as long
       
   278    as you include a copy of the sourcecode when you sell it.  Or you
       
   279    can distribute your code without getID3 and say "download it from
       
   280    getid3.sourceforge.net"
       
   281 
       
   282 
       
   283 
       
   284 Why is it called "getID3()" if it does so much more than just that?
       
   285 ===========================================================================
       
   286 
       
   287 v0.1 did in fact just do that. I don't have a copy of code that old, but I
       
   288 could essentially write it today with a one-line function:
       
   289   function getID3($filename) { return unpack('a3TAG/a30title/a30artist/a30album/a4year/a28comment/c1track/c1genreid', substr(file_get_contents($filename), -128)); }
       
   290 
       
   291 
       
   292 Future Plans
       
   293 ===========================================================================
       
   294 http://www.getid3.org/phpBB3/viewforum.php?f=7
       
   295 
       
   296 * Better support for MP4 container format
       
   297 * Scan for appended ID3v2 tag at end of file per ID3v2.4 specs (Section 5.0)
       
   298 * Support for JPEG-2000 (http://www.morgan-multimedia.com/jpeg2000_overview.htm)
       
   299 * Support for MOD (mod/stm/s3m/it/xm/mtm/ult/669)
       
   300 * Support for ACE (thanks Vince)
       
   301 * Support for Ogg other than Vorbis, Speex and OggFlac (ie. Ogg+Xvid)
       
   302 * Ability to create Xing/LAME VBR header for VBR MP3s that are missing VBR header
       
   303 * Ability to "clean" ID3v2 padding (replace invalid padding with valid padding)
       
   304 * Warn if MP3s change version mid-stream (in full-scan mode)
       
   305 * check for corrupt/broken mid-file MP3 streams in histogram scan
       
   306 * Support for lossless-compression formats
       
   307   (http://www.firstpr.com.au/audiocomp/lossless/#Links)
       
   308   (http://compression.ca/act-sound.html)
       
   309   (http://web.inter.nl.net/users/hvdh/lossless/lossless.htm)
       
   310 * Support for RIFF-INFO chunks
       
   311   * http://lotto.st-andrews.ac.uk/~njh/tag_interchange.html
       
   312     (thanks Nick Humfrey <njh@surgeradio*co*uk>)
       
   313   * http://abcavi.narod.ru/sof/abcavi/infotags.htm
       
   314     (thanks Kibi)
       
   315 * Better support for Bink video
       
   316 * http://www.hr/josip/DSP/AudioFile2.html
       
   317 * http://www.pcisys.net/~melanson/codecs/
       
   318 * Detect mp3PRO
       
   319 * Support for PSD
       
   320 * Support for JPC
       
   321 * Support for JP2
       
   322 * Support for JPX
       
   323 * Support for JB2
       
   324 * Support for IFF
       
   325 * Support for ICO
       
   326 * Support for ANI
       
   327 * Support for EXE (comments, author, etc) (thanks p*quaedackers@planet*nl)
       
   328 * Support for DVD-IFO (region, subtitles, aspect ratio, etc)
       
   329   (thanks p*quaedackers@planet*nl)
       
   330 * More complete support for SWF - parsing encapsulated MP3 and/or JPEG content
       
   331     (thanks n8n8@yahoo*com)
       
   332 * Support for a2b
       
   333 * Optional scan-through-frames for AVI verification
       
   334   (thanks rockcohen@massive-interactive*nl)
       
   335 * Support for TTF (thanks info@butterflyx*com)
       
   336 * Support for DSS (http://www.getid3.org/phpBB3/viewtopic.php?t=171)
       
   337 * Support for SMAF (http://smaf-yamaha.com/what/demo.html)
       
   338   http://www.getid3.org/phpBB3/viewtopic.php?t=182
       
   339 * Support for AMR (http://www.getid3.org/phpBB3/viewtopic.php?t=195)
       
   340 * Support for 3gpp (http://www.getid3.org/phpBB3/viewtopic.php?t=195)
       
   341 * Support for ID4 (http://www.wackysoft.cjb.net grizlyY2K@hotmail*com)
       
   342 * Parse XML data returned in Ogg comments
       
   343 * Parse XML data from Quicktime SMIL metafiles (klausrath@mac*com)
       
   344 * ID3v2 genre string creator function
       
   345 * More complete parsing of JPG
       
   346 * Support for all old-style ASF packets
       
   347 * ASF/WMA/WMV tag writing
       
   348 * Parse declared T??? ID3v2 text information frames, where appropriate
       
   349     (thanks Christian Fritz for the idea)
       
   350 * Recognize encoder:
       
   351   http://www.guerillasoft.com/EncSpot2/index.html
       
   352   http://ff123.net/identify.html
       
   353   http://www.hydrogenaudio.org/?act=ST&f=16&t=9414
       
   354   http://www.hydrogenaudio.org/?showtopic=11785
       
   355 * Support for other OS/2 bitmap structures: Bitmap Array('BA'),
       
   356   Color Icon('CI'), Color Pointer('CP'), Icon('IC'), Pointer ('PT')
       
   357   http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm
       
   358 * Support for WavPack RAW mode
       
   359 * ASF/WMA/WMV data packet parsing
       
   360 * ID3v2FrameFlagsLookupTagAlter()
       
   361 * ID3v2FrameFlagsLookupFileAlter()
       
   362 * obey ID3v2 tag alter/preserve/discard rules
       
   363 * http://www.geocities.com/SiliconValley/Sector/9654/Softdoc/Illyrium/Aolyr.htm
       
   364 * proper checking for LINK/LNK frame validity in ID3v2 writing
       
   365 * proper checking for ASPI-TLEN frame validity in ID3v2 writing
       
   366 * proper checking for COMR frame validity in ID3v2 writing
       
   367 * http://www.geocities.co.jp/SiliconValley-Oakland/3664/index.html
       
   368 * decode GEOB ID3v2 structure as encoded by RealJukebox,
       
   369   decode NCON ID3v2 structure as encoded by MusicMatch
       
   370   (probably won't happen - the formats are proprietary)
       
   371 
       
   372 
       
   373 
       
   374 Known Bugs/Issues in getID3() that may be fixed eventually
       
   375 ===========================================================================
       
   376 http://www.getid3.org/phpBB3/viewtopic.php?t=25
       
   377 
       
   378 * Cannot determine bitrate for MPEG video with VBR video data
       
   379   (need documentation)
       
   380 * Interlace/progressive cannot be determined for MPEG video
       
   381   (need documentation)
       
   382 * MIDI playtime is sometimes inaccurate
       
   383 * AAC-RAW mode files cannot be identified
       
   384 * WavPack-RAW mode files cannot be identified
       
   385 * mp4 files report lots of "Unknown QuickTime atom type"
       
   386    (need documentation)
       
   387 * Encrypted ASF/WMA/WMV files warn about "unhandled GUID
       
   388   ASF_Content_Encryption_Object"
       
   389 * Bitrate split between audio and video cannot be calculated for
       
   390   NSV, only the total bitrate. (need documentation)
       
   391 * All Ogg formats (Vorbis, OggFLAC, Speex) are affected by the
       
   392   problem of large VorbisComments spanning multiple Ogg pages, but
       
   393   but only OggVorbis files can be processed with vorbiscomment.
       
   394 * The version of "head" supplied with Mac OS 10.2.8 (maybe other
       
   395   versions too) does only understands a single option (-n) and
       
   396   therefore fails. getID3 ignores this and returns wrong md5_data.
       
   397 
       
   398 
       
   399 
       
   400 Known Bugs/Issues in getID3() that cannot be fixed
       
   401 --------------------------------------------------
       
   402 http://www.getid3.org/phpBB3/viewtopic.php?t=25
       
   403 
       
   404 * 32-bit PHP installations only:
       
   405   Files larger than 2GB cannot always be parsed fully by getID3()
       
   406   due to limitations in the 32-bit PHP filesystem functions.
       
   407   NOTE: Since v1.7.8b3 there is partial support for larger-than-
       
   408   2GB files, most of which will parse OK, as long as no critical
       
   409   data is located beyond the 2GB offset.
       
   410   Known will-work:
       
   411   * all file formats on 64-bit PHP
       
   412   * ZIP  (format doesn't support files >2GB)
       
   413   * FLAC (current encoders don't support files >2GB)
       
   414   Known will-not-work:
       
   415   * ID3v1 tags (always located at end-of-file)
       
   416   * Lyrics3 tags (always located at end-of-file)
       
   417   * APE tags (always located at end-of-file)
       
   418   Maybe-will-work:
       
   419   * Quicktime (will work if needed metadata is before 2GB offset,
       
   420     that is if the file has been hinted/optimized for streaming)
       
   421   * RIFF.WAV (should work fine, but gives warnings about not being
       
   422     able to parse all chunks)
       
   423   * RIFF.AVI (playtime will probably be wrong, is only based on
       
   424     "movi" chunk that fits in the first 2GB, should issue error
       
   425     to show that playtime is incorrect. Other data should be mostly
       
   426     correct, assuming that data is constant throughout the file)
       
   427 
       
   428 
       
   429 
       
   430 Known Bugs/Issues in other programs
       
   431 -----------------------------------
       
   432 http://www.getid3.org/phpBB3/viewtopic.php?t=25
       
   433 
       
   434 * Windows Media Player (up to v11) and iTunes (up to v10+) do
       
   435     not correctly handle ID3v2.3 tags with UTF-16BE+BOM
       
   436     encoding (they assume the data is UTF-16LE+BOM and either
       
   437     crash (WMP) or output Asian character set (iTunes)
       
   438 * Winamp (up to v2.80 at least) does not support ID3v2.4 tags,
       
   439     only ID3v2.3
       
   440     see: http://forums.winamp.com/showthread.php?postid=387524
       
   441 * Some versions of Helium2 (www.helium2.com) do not write
       
   442     ID3v2.4-compliant Frame Sizes, even though the tag is marked
       
   443     as ID3v2.4)  (detected by getID3())
       
   444 * MP3ext V3.3.17 places a non-compliant padding string at the end
       
   445     of the ID3v2 header. This is supposedly fixed in v3.4b21 but
       
   446     only if you manually add a registry key. This fix is not yet
       
   447     confirmed.  (detected by getID3())
       
   448 * CDex v1.40 (fixed by v1.50b7) writes non-compliant Ogg comment
       
   449     strings, supposed to be in the format "NAME=value" but actually
       
   450     written just "value"  (detected by getID3())
       
   451 * Oggenc 0.9-rc3 flags the encoded file as ABR whether it's
       
   452     actually ABR or VBR.
       
   453 * iTunes (versions "X v2.0.3", "v3.0.1" are known-guilty, probably
       
   454     other versions are too) writes ID3v2.3 comment tags using a
       
   455     frame name 'COM ' which is not valid for ID3v2.3+ (it's an
       
   456     ID3v2.2-style frame name)  (detected by getID3())
       
   457 * MP2enc does not encode mono CBR MP2 files properly (half speed
       
   458     sound and double playtime)
       
   459 * MP2enc does not encode mono VBR MP2 files properly (actually
       
   460     encoded as stereo)
       
   461 * tooLAME does not encode mono VBR MP2 files properly (actually
       
   462     encoded as stereo)
       
   463 * AACenc encodes files in VBR mode (actually ABR) even if CBR is
       
   464    specified
       
   465 * AAC/ADIF - bitrate_mode = cbr for vbr files
       
   466 * LAME 3.90-3.92 prepends one frame of null data (space for the
       
   467   LAME/VBR header, but it never gets written) when encoding in CBR
       
   468   mode with the DLL
       
   469 * Ahead Nero encodes TwinVQF with a DSIZ value (which is supposed
       
   470   to be the filesize in bytes) of "0" for TwinVQF v1.0 and "1" for
       
   471   TwinVQF v2.0  (detected by getID3())
       
   472 * Ahead Nero encodes TwinVQF files 1 second shorter than they
       
   473   should be
       
   474 * AAC-ADTS files are always actually encoded VBR, even if CBR mode
       
   475   is specified (the CBR-mode switches on the encoder enable ABR
       
   476   mode, not CBR as such, but it's not possible to tell the
       
   477   difference between such ABR files and true VBR)
       
   478 * STREAMINFO.audio_signature in OggFLAC is always null. "The reason
       
   479   it's like that is because there is no seeking support in
       
   480   libOggFLAC yet, so it has no way to go back and write the
       
   481   computed sum after encoding. Seeking support in Ogg FLAC is the
       
   482   #1 item for the next release." - Josh Coalson (FLAC developer)
       
   483   NOTE: getID3() will calculate md5_data in a method similar to
       
   484   other file formats, but that value cannot be compared to the
       
   485   md5_data value from FLAC data in a FLAC file format.
       
   486 * STREAMINFO.audio_signature is not calculated in FLAC v0.3.0 &
       
   487   v0.4.0 - getID3() will calculate md5_data in a method similar to
       
   488   other file formats, but that value cannot be compared to the
       
   489   md5_data value from FLAC v0.5.0+
       
   490 * RioPort (various versions including 2.0 and 3.11) tags ID3v2 with
       
   491   a WCOM frame that has no data portion
       
   492 * Earlier versions of Coolplayer adds illegal ID3 tags to Ogg Vorbis
       
   493   files, thus making them corrupt.
       
   494 * Meracl ID3 Tag Writer v1.3.4 (and older) incorrectly truncates the
       
   495   last byte of data from an MP3 file when appending a new ID3v1 tag.
       
   496   (detected by getID3())
       
   497 * Lossless-Audio files encoded with and without the -noseek switch
       
   498   do actually differ internally and therefore cannot match md5_data
       
   499 * iTunes has been known to append a new ID3v1 tag on the end of an
       
   500   existing ID3v1 tag when ID3v2 tag is also present
       
   501   (detected by getID3())
       
   502 * MediaMonkey may write a blank RGAD ID3v2 frame but put actual
       
   503   replay gain adjustments in a series of user-defined TXXX frames
       
   504   (detected and handled by getID3() since v1.9.2)
       
   505 
       
   506 
       
   507 
       
   508 
       
   509 Reference material:
       
   510 ===========================================================================
       
   511 
       
   512 [www.id3.org material now mirrored at http://id3lib.sourceforge.net/id3/]
       
   513 * http://www.id3.org/id3v2.4.0-structure.txt
       
   514 * http://www.id3.org/id3v2.4.0-frames.txt
       
   515 * http://www.id3.org/id3v2.4.0-changes.txt
       
   516 * http://www.id3.org/id3v2.3.0.txt
       
   517 * http://www.id3.org/id3v2-00.txt
       
   518 * http://www.id3.org/mp3frame.html
       
   519 * http://minnie.tuhs.org/pipermail/mp3encoder/2001-January/001800.html <mathewhendry@hotmail.com>
       
   520 * http://www.dv.co.yu/mpgscript/mpeghdr.htm
       
   521 * http://www.mp3-tech.org/programmer/frame_header.html
       
   522 * http://users.belgacom.net/gc247244/extra/tag.html
       
   523 * http://gabriel.mp3-tech.org/mp3infotag.html
       
   524 * http://www.id3.org/iso4217.html
       
   525 * http://www.unicode.org/Public/MAPPINGS/ISO8859/8859-1.TXT
       
   526 * http://www.xiph.org/ogg/vorbis/doc/framing.html
       
   527 * http://www.xiph.org/ogg/vorbis/doc/v-comment.html
       
   528 * http://leknor.com/code/php/class.ogg.php.txt
       
   529 * http://www.id3.org/iso639-2.html
       
   530 * http://www.id3.org/lyrics3.html
       
   531 * http://www.id3.org/lyrics3200.html
       
   532 * http://www.psc.edu/general/software/packages/ieee/ieee.html
       
   533 * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/ieee-expl.html
       
   534 * http://www.scri.fsu.edu/~jac/MAD3401/Backgrnd/binary.html
       
   535 * http://www.jmcgowan.com/avi.html
       
   536 * http://www.wotsit.org/
       
   537 * http://www.herdsoft.com/ti/davincie/davp3xo2.htm
       
   538 * http://www.mathdogs.com/vorbis-illuminated/bitstream-appendix.html
       
   539 * "Standard MIDI File Format" by Dustin Caldwell (from www.wotsit.org)
       
   540 * http://midistudio.com/Help/GMSpecs_Patches.htm
       
   541 * http://www.xiph.org/archives/vorbis/200109/0459.html
       
   542 * http://www.replaygain.org/
       
   543 * http://www.lossless-audio.com/
       
   544 * http://download.microsoft.com/download/winmediatech40/Doc/1.0/WIN98MeXP/EN-US/ASF_Specification_v.1.0.exe
       
   545 * http://mediaxw.sourceforge.net/files/doc/Active%20Streaming%20Format%20(ASF)%201.0%20Specification.pdf
       
   546 * http://www.uni-jena.de/~pfk/mpp/sv8/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/sv8/)
       
   547 * http://jfaul.de/atl/
       
   548 * http://www.uni-jena.de/~pfk/mpp/ (archived at http://www.hydrogenaudio.org/musepack/klemm/www.personal.uni-jena.de/~pfk/mpp/)
       
   549 * http://www.libpng.org/pub/png/spec/png-1.2-pdg.html
       
   550 * http://www.real.com/devzone/library/creating/rmsdk/doc/rmff.htm
       
   551 * http://www.fastgraph.com/help/bmp_os2_header_format.html
       
   552 * http://netghost.narod.ru/gff/graphics/summary/os2bmp.htm
       
   553 * http://flac.sourceforge.net/format.html
       
   554 * http://www.research.att.com/projects/mpegaudio/mpeg2.html
       
   555 * http://www.audiocoding.com/wiki/index.php?page=AAC
       
   556 * http://libmpeg.org/mpeg4/doc/w2203tfs.pdf
       
   557 * http://www.geocities.com/xhelmboyx/quicktime/formats/qtm-layout.txt
       
   558 * http://developer.apple.com/techpubs/quicktime/qtdevdocs/RM/frameset.htm
       
   559 * http://www.nullsoft.com/nsv/
       
   560 * http://www.wotsit.org/download.asp?f=iso9660
       
   561 * http://sandbox.mc.edu/~bennet/cs110/tc/tctod.html
       
   562 * http://www.cdroller.com/htm/readdata.html
       
   563 * http://www.speex.org/manual/node10.html
       
   564 * http://www.harmony-central.com/Computer/Programming/aiff-file-format.doc
       
   565 * http://www.faqs.org/rfcs/rfc2361.html
       
   566 * http://ghido.shelter.ro/
       
   567 * http://www.ebu.ch/tech_t3285.pdf
       
   568 * http://www.sr.se/utveckling/tu/bwf
       
   569 * http://ftp.aessc.org/pub/aes46-2002.pdf
       
   570 * http://cartchunk.org:8080/
       
   571 * http://www.broadcastpapers.com/radio/cartchunk01.htm
       
   572 * http://www.hr/josip/DSP/AudioFile2.html
       
   573 * http://home.attbi.com/~chris.bagwell/AudioFormats-11.html
       
   574 * http://www.pure-mac.com/extkey.html
       
   575 * http://cesnet.dl.sourceforge.net/sourceforge/bonkenc/bonk-binary-format-0.9.txt
       
   576 * http://www.headbands.com/gspot/
       
   577 * http://www.openswf.org/spec/SWFfileformat.html
       
   578 * http://j-faul.virtualave.net/
       
   579 * http://www.btinternet.com/~AnthonyJ/Atari/programming/avr_format.html
       
   580 * http://cui.unige.ch/OSG/info/AudioFormats/ap11.html
       
   581 * http://sswf.sourceforge.net/SWFalexref.html
       
   582 * http://www.geocities.com/xhelmboyx/quicktime/formats/qti-layout.txt
       
   583 * http://www-lehre.informatik.uni-osnabrueck.de/~fbstark/diplom/docs/swf/Flash_Uncovered.htm
       
   584 * http://developer.apple.com/quicktime/icefloe/dispatch012.html
       
   585 * http://www.csdn.net/Dev/Format/graphics/PCD.htm
       
   586 * http://tta.iszf.irk.ru/
       
   587 * http://www.atsc.org/standards/a_52a.pdf
       
   588 * http://www.alanwood.net/unicode/
       
   589 * http://www.freelists.org/archives/matroska-devel/07-2003/msg00010.html
       
   590 * http://www.its.msstate.edu/net/real/reports/config/tags.stats
       
   591 * http://homepages.slingshot.co.nz/~helmboy/quicktime/formats/qtm-layout.txt
       
   592 * http://brennan.young.net/Comp/LiveStage/things.html
       
   593 * http://www.multiweb.cz/twoinches/MP3inside.htm
       
   594 * http://www.geocities.co.jp/SiliconValley-Oakland/3664/alittle.html#GenreExtended
       
   595 * http://www.mactech.com/articles/mactech/Vol.06/06.01/SANENormalized/
       
   596 * http://www.unicode.org/unicode/faq/utf_bom.html
       
   597 * http://tta.corecodec.org/?menu=format
       
   598 * http://www.scvi.net/nsvformat.htm
       
   599 * http://pda.etsi.org/pda/queryform.asp
       
   600 * http://cpansearch.perl.org/src/RGIBSON/Audio-DSS-0.02/lib/Audio/DSS.pm
       
   601 * http://trac.musepack.net/trac/wiki/SV8Specification
       
   602 * http://wyday.com/cuesharp/specification.php
       
   603 * http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/Nikon.html