history

更新mp3

                          correctly make the entire resulting file fill an even
                          multiple of 2Kb.
                        - If the tag we are manipulating was read in as a
                          binary tag before we started playing with it, then
                          ID3Lib will record the size of tag before we started
                          fooling around with it.  This way, the padding system
                          can pad the new tag out to the old size if the new
                          tag will still fit inside the old one.  This makes
                          file manipulation much easier when writing tags to
                          existing song files.  If it won't fit, then the new
                          tag will receive padding as per the 2K cluster
                          method.  All this talk of padding only applies if the
                          tag's padding property is set to ID3PD_AUTOMATIC,
                          which it is by default.

10 Aug 1998     2.11    - Replaced ID3C_SetID and GetID with proper field
                          names, and the same with ID3C_SetComp and GetComp.
                          This requires a change in source code for the
                          application.  Without quotes, do a search and
                          replace...

                     "ID3C_SetID,"   replace with "ID3C_Set, ID3FN_ID,"
                     "ID3C_GetID,"   replace with "ID3C_Get, ID3FN_ID,"
                     "ID3C_SetComp," replace with "ID3C_Set, ID3FN_COMPRESSED,"
                     "ID3C_GetComp," replace with "ID3C_Get, ID3FN_COMPRESSED,"

                        - Thanks to a suggestion by Ilana Rudnik, I added a
                          generic frame type called 'ID3FID_UNSUPPORTED' which
                          is only to be used by applications as a
                          'place-holder' in lists and arrays while waiting for
                          ID3Lib to support all the frames.

 6 Aug 1998     2.11    - Created the ID3C_Locate and ID3C_GetNumFrames
                          commands.
                        - Made the documentation an HTML file instead of boring
                          text.

 5 Aug 1998     2.11    - Thanks to Eng-Keong Lee, I have located and fixed a
                          bug which most-of-the-time caused a crash when
                          performing an ID3C_SetID on a frame for the first
                          time.

 3 Aug 1998     2.10    - Fixed a few things to make ID3Lib compile completely
                          cleanly under Linux - thanks to Carlos Puchol for
                          finding the remaining hassles.
                        - Added two commands to adjust the unsync facility -
                          ID3C_SetUnsync and ID3C_GetUnsync.  The default is
                          ID3SY_AUTOMATIC.
                        - Add support for the 2.01 extended tag header.  By
                          default, ID3Lib will NOT write an extended header to
                          tags it creates.  This can be adjusted by the
                          ID3C_SetExtHeader command.
                        - Changed the directory structure so that the required
                          zlib source is now in the same directory as the
                          ID3Lib source.

 2 Aug 1998     2.10    - Fixed a small memory leak which occurred when
                          clearing a tag of frames which were read in from an
                          external binary tag.
                        - Added a 'bugreport.txt' file to the documentation to
                          improve effectiveness of bug reporting.

 1 Aug 1998     2.10    - Adding support for tag padding.  This results in two
                          new commands which operate on ID3_Tag objects:
                          ID3C_SetPadding and ID3C_GetPadding.

 1 Aug 1998     2.09    - Fixed some bugs in the ID3C_ToFile and ID3C_FromFile
                          commands.
                        - Fixed a bug which prevented empty strings which were
                          supposed to be NULL-terminated from doing so.

31 Jul 1998     2.09    - Changed the functionality of the error handling
                          mechanism.  The function interface to the error
                          handler has changed - see the example source file
                          'main.cpp' for details.
                        - Improved frame verification somewhat.

28 July 1998    2.08    - Added ID3C_ToFile command to binary fields.
                        - Changed the format of the ID3C_Size command when
                          applied to frames.  There is now a required second
                          parameter which specifies which field you require the
                          size of.  If you request ID3FN_ALL, you will get the
                          size of the frame itself.
                        - The above change for ID3C_Size now also applies to
                          the ID3C_Clear command (again, only when applied to
                          frames).
                        - Enhanced the ID3C_Find command so as to allow
                          searches based on the ID3FN_LANGUAGE field and the
                          ID3FN_DESCRIPTION field.

27 July 1998    2.07    - Fixed a bug which had the WXX and TXX frames
                          including a language field which they shouldn't.
                        - Fixed a bug in the string's ID3C_Get command which
                          wrongly interpreted the presence of a '/' symbol in 
                          the string as meaning that the string was a textlist.

21 July 1998    2.06    - Added support for frame compression via zlib.  This 
                          means that all frames have an extra attribute which
                          specifies whether the frame should be compressed.
                        - Changed some typedefs and macro names so as not to
                          clash with some of Windows' pre-defined
                          datatypes/names.  Thanks to Chuck Zenkus for finding
                          this.

14 July 1998    2.05    - Finished up Unicode support.  All internal string
                          handling is done with Unicode strings.  Strings are
                          converted as needed during rendering of the tag.

 6 July 1998    2.05    - BINARY fields now support an 'ID3C_FromFile' command
                          which fills the field with data from the specified
                          file.  The file is read and the contents placed in
                          the field immediately on the field encountering this
                          command.

 2 July 1998    2.04    - Improved support for frame validation.
                        - Repaired a cool bug in the error handling which
                          prevented an application from finding further
                          information about the error.  This fix resulted in a
                          new format for the application error handler
                          function.

                2.03    - Added support for the ID3C_Add, ID3C_Remove,
                          ID3C_GetElement, ID3C_GetNumElements commands in the
                          STRING field type.  This allows easy use of the text
                          lists as used in the 'TP1' frame.

                        - Improved error handling once more.
                        - Added support for the ID3C_Increment command in the
                          INT field type.
                        - Added support for the CNT, POP, GEO, TCO, TCR and UFI
                          frames.
                        - Added preliminary validation checking for frames to
                          ensure they meet the ID3v2 standard requirements.
                          Not fully implemented.

                2.02    - Adjusted the '::Do()' function slightly - you can now
                          chain commands together.  The last parameter to this
                          call must now always be 'ID3C_DONE'.
                
 1 July 1998    2.01    - Added the 'ID3_IsTagHeader()' function and an
                          appropriately adjusted ID3C_Parse command.

30 June 1998    2.00    - First preliminary release of ID3Lib v2.00.  Supports
                          lots of frames (even PIC).  Lots of work still
                          needed.

25 June 1998    2.00    - Abandoned the v1.xx framework in favour of a more
                          versatile and expandable one.  This required a major
                          re-write of most of the internals of the library as
                          well as changes to any applications using the
                          previous framework.  The new framework is part of all
                          ID3Libs which are 2.xx.

23 June 1998    1.01    - Released v1.01 which added support for four new
                          frames.  TXX, WXX, COM, ULT

21 June 1998    1.00    - Initial Release (v1.0)