--- libgig/trunk/ChangeLog	2005/11/22 11:26:55	809
+++ libgig/trunk/ChangeLog	2018/12/22 18:59:29	3442
@@ -1,10 +1,505 @@
-Version CVS HEAD (?)
+Version SVN trunk (?)
+
+  * src/gig.cpp, src/gig.h:
+    - Fixed Doxygen API comments for enum types (currently latest Doxygen
+      [v1.8.13] only supports C comments in macro arguments expansion, but
+      not C++ comments; see <FindDefineArgs> lexer rules in src/pre.l of
+      the Doxygen source code, which currently also filter out new line
+      \n chars).
+    - Added new method File::CountSamples().
+    - Added new method File::CountInstruments().
+    - Fixed gig v4 files falsely being handled as v2 format
+      (patch by Ivan Maguidhir).
+    - Added gig v4 version identifier (File::VERSION_4).
+    - GIG FORMAT EXTENSION: Added attribute
+      DimensionRegion::SustainReleaseTrigger which allows to define whether
+      a sustain pedal up event shall cause a release trigger sample to be
+      played (default: don't play release trigger sample by sustain pedal).
+
+  * src/Serialization.cpp, src/Serialization.h:
+    - Hide pure internal declarations from header file to avoid numerous
+      compiler warnings when building and linking against the public API.
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - Fix: Calling File::SetMode() left an undefined file handle on Windows and
+      caused a resource leak
+
+  * src/tools/gigdump.cpp:
+    - Added command line option --instrument-names which causes only
+      instrument names and their index numbers to be printed.
+
+Version 4.1.0 (25 Nov 2017)
+  * general changes:
+    - removed 2 GB limitation when loading a gig or DLS file
+    - using now native integer size where appropriate
+    - fixed minor issues with man pages (patch by Debian maintainer)
+    - fixed various spelling mistakes (patch by Debian maintainer)
+    - Added new "Serialization" framework (and equally named namespace)
+      which allows to serialize and deserialize native C++ objects
+      in a portable, easy and flexible way.
+    - print compiler warning if no RTTI available
+    - Fixed potential crash in command line tools gig2stereo, korg2gig,
+      korgdump and sf2extract.
+    - Fixed CVE-2017-12950, CVE-2017-12952, CVE-2017-12953
+      (original patch by Paul Brossier, slightly modified).
+    - Debian: Fixed packaging error about invalid substitution variable
+      "Source-Version".
+    - Raised Debian compatibility level to Debian 9 "Stretch".
+
+  * src/gig.cpp, src/gig.h:
+    - fixed bug in Script::SetGroup: the script chunk wasn't moved
+    - fixed compilation error with clang 3.4
+    - GIG FORMAT EXTENSION: added support for saving gig file larger than 4 GB
+      as one single monolithic gig file. In case .gig file is >= 2GB expect a
+      large monolithic file, otherwise if .gig file is < 2 GB check for
+      "extension" files (.gx01, .gx02, ...) instead.
+    - fixed Region::UpdateUpdateVelocityTable() which did not work correctly
+      if there were dimensions after the velocity dimension: it only created
+      valid velocity tables for cases of dimensions lower than the velocity
+      dimension.
+    - added new method Sample::VerifyWaveData() which allows to check whether
+      a sample had been damaged for some reason
+    - Fix: samples' CRC checksums were damaged on file structure changes.
+    - Fix: samples' CRC checksums were misordered when a Sample was deleted.
+    - Added new method Sample::GetWaveDataCRC32Checksum().
+    - Changed default value of EG2Release (filter release time) to 60s.
+    - Instruments' default pitch bend range is now +-2 semi tones.
+    - Fixed CRC checksums being wrong sometimes.
+    - Fix: method File::AddContentOf() did not clone script groups and scripts
+      of passed original file.
+    - Added support for serializing & deserializing DimensionRegion
+      objects (and crossfade_t and leverage_ctrl_t objects).
+    - Added enum reflection API functions for retrieving enum declaration type
+      information at runtime (enumCount(), enumKey(), enumKeys(), enumValue()).
+    - Exception class now has a variadic constructor which allows to add
+      textual format specifiers like with printf().
+    - On unknown leverage controller exception: show precise unknown leverage
+      controller number found.
+    - Ignore invalid leverage controller types and just show a warning on the
+      console instead of throwing an exception.
+    - Added new struct eg_opt_t and new class member variable
+      DimensionRegion::EG1Options and DimensionRegion::EG2Options as an
+      extension to the gig file format, which allows to override the default
+      behavior of the first two EGs' state machines.
+    - Fixed undefined behavior when loading a gig file with invalid
+      velocity curve parameters (fixes CVE-2017-12951).
+    - Fixed undefined behavior when loading a gig file with invalid wave
+      pool index number (fixes CVE-2017-12954).
+
+  * src/DLS.cpp, src/DLS.h:
+    - Sample: wave pool offsets are now 64 bits (to allow support for files
+      larger than 4 GB).
+    - Exception class now has a variadic constructor which allows to add
+      textual format specifiers like with printf().
+      
+  * src/RIFF.cpp, src/RIFF.h:
+    - added support for RIFF files larger than 4 GB, by default the required
+      internal RIFF file offset size is automatically detected (that is RIFF
+      files < 4 GB automatically use 32 bit offsets while files >= 4 GB
+      automatically use 64 bit offsets), a particular offset size can be forced
+      with a new option added to the RIFF File constructor though
+    - when saving a modified, grown RIFF file, the temporary file size during
+      Save() operation will no longer be larger than the final grown file size
+    - Exception class now has a variadic constructor which allows to add
+      textual format specifiers like with printf().
+
+  * src/Serialization.cpp, src/Serialization.h:
+    - Archive: Added method isModified().
+    - Archive: Added method setAutoValue().
+    - Archive: Added method setIntValue().
+    - Archive: Added method setRealValue().
+    - Archive: Added method setBoolValue().
+    - Archive: Added method setEnumValue().
+    - Archive: Added method valueAsString().
+    - Archive::rawData(): Automatically re-encode new raw data stream if
+      archive had been modified (i.e. by remove(), setAutoValue(), etc.).
+    - Object: Added method memberByUID().
+    - Object: remove() method is now protected.
+    - Archive: Added method removeMember().
+    - Archive: Added methods name() and setName().
+    - Archive: Added methods comment() and setComment().
+    - Archive: Added methods timeStampCreated(), timeStampModified(),
+      dateTimeCreated() and dateTimeModified().
+    - Archive: Added methods valueAsInt(), valueAsReal() and valueAsBool().
+    - DataType: Implemented demangling C++ type names (for methods
+      asLongDescr() and customTypeName(bool demangle=false)).
+    - Archive::setAutoValue(): Handle human readable boolean text
+      representations like "yes", "no", "true", "false" as expected.
+    - Exception class now has a variadic constructor which allows to add
+      textual format specifiers like with printf().
+    - DataType fix: Retain backward compatibility to older versions of native
+      C++ classes/structs.
+
+  * src/Akai.cpp:
+    - Fixed compilation error with recent, more strict compilers.
+
+  * src/tools/akaidump.cpp, src/tools/akaiextract.cpp:
+    - improved output of non-ascii characters in usage messages
+    - fixed printf format strings
+
+  * src/tools/korg2gig.cpp:
+    - fixed c++11 narrowing warnings
+    - fixed fine tuning which was not translated at all
+
+  * src/tools/gigdump.cpp:
+    - additionally print VelocityUpperLimit and DimensionUpperLimits of all
+      dimension regions
+    - additionally print RIFF chunk file offset and RIFF chunk size of sample
+      data
+    - added and implemented new parameter "--verify" which allows to check
+      the raw wave form data integrity of all samples
+    - added and implemented new parameter "--rebuild-checksums" which allows
+      to recalculate the CRC32 checksum of all samples' raw wave data and
+      rebuilding the gig file's global checksum table (i.e. in case the
+      file's checksum table was damaged)
+    - print samples' CRC32 checksums
+    - Print the new EG behavior options (eg_opt_t).
+
+  * src/tools/gigextract.cpp:
+    - Fix: if sample name contains a path separator (slash or backslash) then
+      replace them by a minus sign to avoid file system issues.
+
+  * src/tools/gig2stereo.cpp:
+    - Also merge mono sample pairs with non matching loop information if
+      argument --incompatible was given.
+
+  * packaging changes:
+    - Automake: set environment variable GCC_COLORS=auto to allow GCC to
+      auto detect whether it (sh/c)ould output its messages in color.
+
+Version 4.0.0 (14 Jul 2015)
+  * general changes:
+    - minor Makefile fix for parallel make
+    - Mac OS X: link with CoreFoundation (for the UUID function)
+    - removed gcc 4.7 warnings
+    - modernized configure script
+    - removed usage of deprecated Automake variable INCLUDES
+    - added new command line tool "gigmerge"
+    - added "const" keyword to several methods
+    - added new command line tool "gig2mono"
+    - added man page for "sf2dump"
+    - added new command line tool "korgdump" (and a man page for it)
+    - added new command line tool "korg2gig" (and a man page for it)
+    - moved source files of command line tools to new subdir src/tools
+    - libgig.so and libakai.so files are now installed under
+      $(prefix)/lib/libgig/ by default.
+    - Header files are now installed under $(prefix)/include/libgig/ by default.
+    - Fixed various packaging issues regarding installation directories
+      (fixes #218).
+    - added new command line tool "gig2stereo" (and a man page for it)
+    - unit tests: fixed wrong return value when test suite app exits
+      (patch by Ryan Schmidt)
+    - added new command line tool "sf2extract" (and a man page for it)
+
+  * SoundFont file format:
+    - initial implementation
+    - changed region lookup API to avoid malloc in RT threads
+    - fixed GetEG1Sustain which didn't return correct value
+    - bugfix: GetPan always returned -1, 0 or 1
+
+  * KORG file format:
+    - initial support for sample based instruments in KORG's file format
+      (.KMP and .KSF files)
+
+  * AKAI file format:
+    - Added Linux/POSIX ported version of libakai. Note that libakai is released
+      under LGPL terms while libgig is released under GPL terms. To handle this
+      license difference appropriately the AKAI support part is built as
+      separate DLL (.so file).
+    - Fixed Mac OSX support so that the Akai lib files and tools compile without
+      any exotic third party libraries.
+    - Fixed various compilation errors for Windows.
+    - POSIX fix: open() requires third (mode) argument if used with O_CREAT
+      (fixes #219).
+
+  * src/gig.cpp:
+    - bugfix: VCF velocity dynamic range and VCF velocity curve
+      weren't saved correctly
+    - implemented File::AddDuplicateInstrument()
+    - bugfix: negative EG3 depth values were not correctly parsed or
+      saved
+    - added write support for CtrlTrigger midi rule
+    - added read and write support for Legato and Alternator midi
+      rules
+    - bugfix: sample groups were sometimes created multiple times or with
+      wrong textual group name
+    - added new method File::AddContentOf() for merging .gig files
+    - GIG FORMAT EXTENSION: added additional MIDI controllers for leverage
+      controller types (only works with LinuxSampler & gigedit, will not
+      work with Gigasampler/GigaStudio)
+    - added new method File::GetGroup(String name) for getting group by name
+    - added new method Region::GetDimensionDefinition(dimension_t type)
+    - bugfix: don't alter region pointer in DimensionRegion::CopyAssign()
+    - added some more sanity checks in Region::AddDimension()
+    - added new method Region::DeleteDimensionZone(dimension_t, int)
+    - added new method Region::SplitDimensionZone(dimension_t, int)
+    - Fixed crash caused by Region::GetDimensionRegionByValue() that happened
+      with certain velocity split sounds under certain conditions (added bound
+      constraints to prevent that)
+    - GIG FORMAT EXTENSION: added support for real-time instrument scripts.
+    - added new method Region::GetDimensionRegionIndexByValue()
+    - added new method Script::GetGroup()
+    - added new method Region::SetDimensionType()
+    - Added support for custom progress notification while saving to gig file.
+    - Bugfix: Adding a new region in between two existing regions caused the
+      new one being dropped after save operation and the gig file being tainted
+      (chunks at wrong location in the RIFF tree).
+    - Added new method Instrument::MoveTo() which allows to rearrange the order
+      of instruments within the same gig file.
+
+  * src/DLS.cpp, src/DLS.h:
+    - added new method File::GetFileName()
+    - fixed minor "memory leak on exception" bug found with cppcheck
+    - added new method File::GetExtensionFile(int index)
+    - added new method File::SetFileName() allowing to call File::Save()
+      later on without passing a file name
+    - added inline helper methods overlaps() for struct range_t
+    - Added support for custom progress notification while saving to DLS file.
+    - Bugfix: Adding a new region in between two existing regions caused the
+      new one being dropped after save operation and the gig file being tainted
+      (chunks at wrong location in the RIFF tree).
+
+  * src/SF.cpp, src/SF.h:
+    - added new method Sample::ReadNoClear()
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - bugfix: avoid calling read() with count 0 when writing a file,
+      as this may hang on some systems
+    - fixed memory leak and memory handling errors when file loading
+      fails
+    - added new method Chunk::ReadString
+    - added new method File::SetFileName() allowing to call File::Save()
+      later on without passing a file name
+    - added new method File::IsNew()
+    - added support for loading RIFF-like files with a bit different layout
+      than "real" RIFF files (used for KORG format support)
+    - added new method Chunk::GetFile()
+    - added new method Chunk::GetLayout()
+    - added 2nd, alternative method for List::MoveSubChunk(), the old 1st one
+      allows to move a subchunk within the current List, whereas the new 2nd
+      one allows to move the subchunk from the current list to another list
+    - POSIX: only assume -1 result value as error on open() calls
+    - POSIX: show operating system's error reason if opening a file failed
+    - Added support for custom progress notification while saving to RIFF file.
+    - Fixed embarrassing old bug: POSIX read() errors were never detected on
+      Chunk::Read() calls due to signment incompatible variable. 
+    - Cleanup of an old DLL binary backward compatibility hack.
+
+  * src/gigextract.cpp:
+    - export sample loop, unity note and fine tune with libsndfile
+
+  * src/riftree.cpp:
+    - added more command line options for being able to also dump other kind
+      of file formats similar but not equal to the RIFF format
+
+Version 3.3.0 (30 Jul 2009)
+
+  * general changes:
+    - fixed compilation with gcc 4.3
+    - fixes for building with Visual C++
+    - minor fix in configure for building DLL on Windows
+
+  * src/gig.cpp, src/gig.h:
+    - added partial support for MIDI rules, only the Controller
+      Triggered rule is supported so far
+    - bugfix: removed another iterator invalidation in DeleteSample
+    - bugfix in Sample::LoadSampleData*(): reset sample read position to
+      sample start before trying to (re)load sample data from file (#82)
+    - bugfix: EG3 depth parameter was not saved correctly
+    - fixed crash which occured when streaming a gig sample with
+      bi-directional (a.k.a. 'pingpong') loop type (fixes #102)
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - bugfix: saving to the same file after the file size had been
+      increased made the file corrupt (#82)
+    - bugfix: refuse Chunk::Read() in case chunk has just been added, that
+      is not written physically yet (#82)
+    - bugfix: saving to the same file after the file size had been
+      decreased sometimes also made the file corrupt!
+    - bugfix: undefined behavior (e.g. endless loop) when opening zero
+      length files, now throws a RIFF::Exception instead (fixes bug #121)
+    - bugfix: destructor for base class RIFF::Chunk accessed members
+      of derived class RIFF::File, which is bad, and caused crashes
+      when using Visual C++
+    - bugfix: files that contain zero length RIFF lists were not read
+      correctly (fixes #127) (bug was introduced 2009-03-13)
+
+Version 3.2.1 (5 Dec 2007)
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - avoid Windows to perform unnecessary file stream caching which would
+      decrease disk streaming performance on Windows systems otherwise
+
+  * src/gig.cpp, src/gig.h:
+    - added File::SetAutoLoad() and File::GetAutoLoad() for allowing
+      applications to retrieve very superficial informations like amount of
+      instruments and their names in a very fast way
+
+Version 3.2.0 (14 Oct 2007)
+
+  * packaging changes:
+    - added Mac OSX XCode project files (patch by Toshi Nagata)
+    - Dev-C++ (win32) project file is automatically updated with
+      the version info from configure.in
+    - the configure script can now be used in Windows with MSYS
+    - added a mainpage for the Doxygen API documentation
+
+  * src/DLS.cpp, src/DLS.h:
+    - added Sampler::AddSampleLoop() and Sampler::DeleteSampleLoop() methods
+    - fixed write support for big-endian systems
+    - improved handling of fixed length info strings - separate default
+      lengths can be specified for each INFO chunk
+    - added Resource::GenerateDLSID function
+    - write support fix: allow regions without mapped samples
+    - added method SetKeyRange() to the Region class which should be used
+      instead of setting the KeyRange member variable directly
+    - MoveRegion() method of Region class is now private
+    - added SetGain() method to Sampler class
+    - fixed crash when saving a file after a sample loop was added
+
+  * src/gig.cpp, src/gig.h:
+    - fixed segmentation fault in the gig::File destructor sequence which
+      happened when gig::Group informations were accessed before
+    - fixed write support for big-endian systems
+    - defined lengths of a fixed set of info strings. These strings
+      are saved when the file is written, even if they are empty.
+    - added missing parameter initalizations in sample, region and
+      instrument constructors
+    - clear unused fields when saving samples and regions
+    - fixed write support bugs: v3 dimension limits and chunksize
+      weren't saved, leverage controller of type controlchange
+      couldn't be saved, group name list chunk was placed wrong,
+      dimension region chunks also placed wrong
+    - added initialization of some fixed info strings in file and
+      instrument
+    - write support: files created by libgig will now have the RIFF
+      chunks in correct order
+    - write support: two previously unknown fields in dimension
+      definition are now saved
+    - added constants for gig file versions
+    - write support: the 3crc and einf chunks are now created or
+      updated when a file is saved (3crc contains sample checksums,
+      einf contains file statistics)
+    - write support: DLSID is now generated on the file and the
+      instruments
+    - write support: improved the default values for dimension region
+      parameters
+    - more write support fixes: crossfade parameters were not saved,
+      v3 dimension limits were not correctly initialized and saved
+      when dimensions were added or deleted, v3 wave pool offsets were
+      not saved correctly
+    - write support: 24 bit samples can now be written
+    - write support: version 3 is now the default for new files
+    - more write support fixes: the 3ewg chunk is now bigger for v3,
+      dimension regions without mapped samples are now allowed, 3gnl
+      list in v3 files now always has 128 entries, several parameters
+      where incorrectly saved due to an operator precedence mistake
+    - DeleteSample now removes all references to the deleted sample
+    - AddDimension now copies all parameters from existing dimension
+      regions and also makes sure that the samplechannel dimension is
+      placed first in the list of dimensions.
+    - added method GetParent() to class 'DimensionRegion', which returns its
+      parent Region
+    - fixed Instrument::UpdateRegionKeyTable() method which did not reset
+      unused areas
+    - added various setter methods to DimensionRegion class which take care
+      of updating lookup tables / caches.
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - added File::SetByteOrder method
+    - Windows fix: saving a new file didn't work
+
+  * src/gigdump.cpp:
+    - added some missing dimension strings
+
+Version 3.1.1 (24 Mar 2007)
+
+  * packaging changes:
+    - ported to Windows using native Windows functions for file IO
+      (provided Dev-C++ + mingw project file)
+    - only export relevant files to Doxygen API documentation
+
+  * src/gig.cpp, src/gig.h:
+    - custom velocity splits now works for gig v3 files too
+    - added support for custom splits points for other dimensions than
+      velocity (gig v3 feature)
+    - added "smart midi" and "round robin keyboard" dimensions
+    - added new method File::DeleteGroupOnly() which only deletes the given
+      group but moves all its members to another group, the other method,
+      that is File::DeleteGroup() now removes not just the group, but also
+      all the samples that belong to that group
+    - fixed crash which occured on interfering File::DeleteSample() and
+      File::GetNextSample() calls (due to iterator invalidation)
+    - fixed group names which were not saved
+    - fixed group destructor which did not remove the RIFF chunk associated
+      with the group
+    - added Instrument::MoveRegion method
+    - fixed constructor for Region, which did not initialize correctly
+      when used from Instrument::AddRegion
+    - when saving, override the gig::Regions sample reference simply by
+      the region's first dimension region's sample (avoids an exception
+      when trying to save a new instrument)
+    - fixed AddDimension() method which did not fill out all mandatory
+      dimension definition fields
+
+  * src/DLS.cpp, src/DLS.h:
+    - added Instrument::MoveRegion method
+    - fixed software info field which was wrongly stored on instruments,
+      causing an exception when trying to save a new instrument
+
+  * src/RIFF.cpp, src/RIFF.h:
+    - fixed RIFF::Chunk destructor which did not unregister previously
+      resized chunks, leading to a "zero size chunk" exception when
+      File::Save() was called
+    - added List::MoveSubChunk method
+
+Version 3.1.0 (24 Nov 2006)
+
+  * packaging changes:
+    - changed deprecated copyright attribute to license;
+      added ldconfig to post-(un)install steps on libgig.spec (RPM)
+
+  * src/gig.cpp, src/gig.h:
+    - added support for more than one set of custom velocity splits
+      inside a region (for example different velocity split levels for
+      pedal up and pedal down)
+    - sample loop parameters are now taken from the DimensionRegion
+      instead of the wave chunk
+    - keyswitching dimension is changed from split type "normal" to
+      "bit"
+    - real support for 24 bit samples - samples are not truncated to
+      16 bits anymore
+    - support for reading of ".art" files. (Merging of .art and .gig
+      files are not implemented yet.)
+    - several fixes for the write support
+    - support for sample groups added
+
+  * src/DLS.cpp, src/DLS.h:
+    - support for reading of ".art" files
+    - removed incorrect use of memccpy in the write support (patch by
+      Jeremy Kerr)
+    - several fixes for the write support
+
+  * src/gigextract.cpp:
+    - real support for 24 bit samples
+
+  * src/gigdump.cpp:
+    - print global file informations
+    - print sample groups
+
+  * general changes:
+    - added CPPUnit test cases (at the moment primarily for automatic check
+      of Gigasampler write support)
+
+Version 3.0.0 (28 Apr 2006)
 
   * general changes:
     - added write support (that is for creating and modifying RIFF, DLS and
       gig files)
     - loading DLS and gig files is now much more permissive, DLS and gig
       files are now loaded even if mandatory RIFF chunks are missing
+    - fixed some memory management errors, one of them was causing a
+      crash when a multi-file gig was deallocated
 
   * src/gig.cpp, src/gig.h:
     - fixed the GetVelocityCutoff function, it wasn't always using the