history

更新mp3

$Id: HISTORY,v 1.3 2000/04/17 05:05:01 eldamitri Exp $

ID3Lib History

The following is a history of id3lib up to version 3.05a.  Please see the
NEWS file for changes since then.

23 Nov 1998     3.05a   - Released 3.05a in which the only change was the 
                          inclusion of a C header file for using the DLL
                          (how forgetful I am!).

22 Nov 1998     3.05    - Released 3.05 and the DLL.

 8 Nov 1998     3.05    - Finished the first revision of the DLL.  Interesting
                          stuff.  Contains both C++ class and C functions (the
                          C++ classes that are exported to the DLL are Tag,
                          Frame, Field and Error).
                        - Took out the SetVersion function from the ID3_Tag 
                          class.  This is because I no longer wish ID3Lib to be
                          able to create the old ID3v2-2.0 tags.  ID3Lib will
                          always create the latest version tags it is capable
                          of creating.

 1 Nov 1998     3.05    - Removed the encryption and grouping stuff.  I have a
                          lot to do before I finish that section and I might 
                          end up implementing it differently, so I thought it
                          best to remove it before people started using it 
                          (no-one should since it wasn't fully functional
                          anyway).

13 Oct 1998     3.05    - Work has begun on the Windows DLL.

 9 Oct 1998     3.04    - Added the text list handling functions from 2.16, but
                          they are slightly different under 3.xx.
                        - Also added a Size() function for fields which
                          applications can use to allocate buffers and so on.
                        - Work has progressed on the encryption and grouping
                          side of things, but nothing usable by an application
                          just yet.

 5 Oct 1998     3.04    - Changed the ID3_AddHandler() function to include a
                          parameter which specifies the factor by which the 
                          size of the frame may increase as a result of
                          encryption or encoding.  This is used for buffer and
                          size estimates.

 3 Oct 1998     3.03a   - Fixed a small Unicode BOM bug.

 2 Oct 1998     3.03    - Added very minimal and not-totally-functional support
                          for the automatic handling of encryption and
                          grouping.
                        - Added a function to ID3_Tag which makes attaching
                          arrays of ID3_Frame objects easy.

 1 Oct 1998     3.03    - Yesterday, ID3v2-3.0 became an informal standard.  
                          Due to this, ID3Lib now does not create ID3v2-3.0
                          tags with the EXPERIMENTAL bit set.

30 Sep 1998     3.02    - Expanded the error handling class to include
                          functions which return the ID3Lib source file and
                          line number of the exception. This is useful for
                          debugging and generating bug reports (hint, hint).

28 Sep 1998     3.02    - Added the grouping registration and encryption
                          registration frames.  Also added support for parsing
                          and rendering frames with the grouping and encryption
                          symbols, although currently this data is ignored.  I
                          plan to implement call backs to handle the encryption
                          and decryption of data.  Also, there is currently no
                          checking at render-time that all frames which have
                          these symbols also have a corresponding rego frame.

26 Sep 1998     3.02    - Changed the 'tag changed' stuff so that calls to
                          ID3_Tag::SetVersion(), ID3_Tag::SetCompression() etc
                          now constitute a change in the tag.  This is because
                          of the relaxed restrictions on the calls to these
                          functions before rendering/updating.  - Fixed a bug
                          in the ID3_Tag::Link() command.

25 Sep 1998     3.01    - Added the ID3_Tag::RemoveFrame() function.
                        - Added the ID3_Tag::SetExtendedHeader() function, even
                          though this setting is currently ignored.
                        - Added luint return type to the Field::Get() functions
                          for ASCII and Unicode strings.  These functions now
                          return how many characters (not bytes necessarily) of
                          the supplied buffer were used, not including the
                          NULL-termination.
                        - Added the 'unique file identifier' frame which I
                          omitted from 3.00 but was present in 2.xx.
                        - Added code that allows ID3Lib and applications to
                          track whether a tag has been altered since the last
                          parse or render.
                        - Slightly altered the padding strategy when a tag 
                          shrinks in size.
                        - No more requirements on when ID3_Tag::SetVersion()
                          etc must be called, except that they should be called
                          prior to an update or render if you plan to use
                          different settings than the defaults.

21 Sep 1998     3.00    - Released 3.00

15 Sep 1998     3.00    - Added support for parsing and converting ID3v1/1.1
                          and Lyrics3 v2.0 tags and CDM frames from 2.01
                          experimental tags.  Also parses Unicode now.

 9 Sep 1998     3.00    - Work almost done on 3.00.  A little bit to fix up in
                          the parsing department (doesn't parse Unicode yet, or
                          CDMs from the old 2.01 draft).  Then just add
                          validity checking and support for most of the frames.

 2 Sep 1998     2.16    - Small Unicode string parsing bug fixed.

25 Aug 1998     2.15    - Small bug fixes in the tag parsing routines.
                        - Completely removed support for creating extended
                          headers, and ID3Lib will now ignore tags which have
                          the EXTENDEDHEADER bit set (as under 2.00, this bit
                          isn't defined).

24 Aug 1998     2.14    - Small bug fixes in the example file 'convert.cpp'.
                        - ID3Lib now sets the EXPERIMENTAL bit in the tag
                          header.

13 Aug 1998     2.13    - As of 2.13, ID3Lib now comes in two flavours.  The
                          first is the normal distribution as we have come to
                          know and love.  The second is a machine-specific
                          archive which contains the static link libraries.
                          Currently, you can get Win32 link libraries.

12 Aug 1998     2.12    - As of 2.12, the ID3Lib distribution will contain
                          precompiled static libraries for Visual C++ and
                          eventually for Linux i386.  The MSVC static libs are
                          be compiled for the multi-threaded run-time library
                          and there will be one for debugging and one normal
                          one for release-quality applications.

                        - Fixed a small exclusion in the 'id3_support.h' file.
                          It now contains a #include for the 'wchar.h' header
                          file.  The absence of this line resulted in some
                          applications producing compilation errors if they
                          didn't already include it or 'stdio.h'.

11 Aug 1998     2.12    - I created a small problem in 2.11 where the name of
                          the URL field in the 'ID3FID_WWWUSER' frame ('WXX')
                          was changed from ID3FN_URL to ID3FN_TEXT.  This has
                          been fixed (is back to ID3FN_URL).
                        - When reading a binary tag, previous versions of
                          ID3Lib ignored the fact that some of the frames in
                          the tag may have been compressed, so when writing the
                          tag back out, those old frames were written without
                          compression.  This is fixed so that all old frames
                          are written back out as they were read in, unless of
                          course you explicitly change the compression status
                          before rendering the new tag.
                        - Added the ID3C_SetSongSize and ID3C_GetSongSize
                          commands to the ID3_Tag class.  These allow you to
                          tell ID3Lib how big (in bytes) the song file is to
                          which you intend attaching the tag.  ID3Lib can then
                          work out how much padding the tag requires to