Contents of /libgig/trunk/ChangeLog

Version SVN trunk (?)

  * src/gig.cpp, src/gig.h:
    - Region::DeleteDimensionZone(): Fix clang sanatizer warning.
    - Region::SplitDimensionZone(): Fix clang sanatizer warning.
    - Sample: Fix unnecessary RAM consumption in case of 24 bit samples
      (InternalDecompressionBuffer is no longer needed for 24 bit samples since
      SVN r902 / libgig release 3.1.0).
    - Use GetSubChunkAt() instead of GetFirstSubChunk() / GetNextSubChunk() in
      entire gig.cpp file.
    - Use GetSubListAt() instead of GetFirstSubList() / GetNextSubList() in
      entire gig.cpp file.
    - Added method Instrument::GetRegionAt().
    - Marked methods Instrument::GetFirstRegion() and
      Instrument::GetNextRegion() as deprecated.
    - Use GetRegionAt() instead of GetFirstRegion() / GetNextRegion() in entire
      gig.cpp file.
    - Changed signature of method File::GetSample(uint) to
      File::GetSample(size_t,progress_t*).
    - Marked methods File::GetFirstSample() and File::GetNextSample() as
      deprecated.
    - Use File::GetSample() instead of File::GetFirstSample() /
      File::GetNextSample() in entire gig.cpp file.
    - Added method Group::GetSample().
    - Marked methods Group::GetFirstSample() and Group::GetNextSample() as
      deprecated.
    - Use Group::GetSample() instead of Group::GetFirstSample() /
      Group::GetNextSample() in entire gig.cpp file.
    - Changed signature of method File::GetGroup(uint) to
      File::GetGroup(size_t).
    - Fixed File::GetGroup(size_t) to be reentrant-safe.
    - Marked methods GetFirstGroup() and GetNextGroup() as deprecated.
    - Fixed GetGroup(String) to be reentrant-safe.
    - Use GetGroup() instead of GetFirstGroup() / GetNextGroup() in entire
      gig.cpp file.
    - Changed signature of method File::GetInstrument(uint,progress_t*) to
      File::GetInstrument(size_t,progress_t*).
    - Fixed File::GetInstrument(size_t,progress_t*) to be reentrant-safe.
    - Marked methods File::GetFirstInstrument() and File::GetNextInstrument()
      as deprecated.
    - Use File::GetInstrument() instead of File::GetFirstInstrument() /
      File::GetNextInstrument() in entire gig.cpp file.
    - Optimized method ScriptGroup::GetScript() to have constant time
      efficiency.
    - Changed signature of method File::GetScriptGroup(uint) to
      File::GetScriptGroup(size_t).
    - Optimized method File::GetScriptGroup(size_t) to have constant time
      efficiency.
    - Changed signature of method ScriptGroup::GetScript(uint) to
      ScriptGroup::GetScript(size_t).
    - Changed signature of method Instrument::GetScriptOfSlot(uint) to
      Instrument::GetScriptOfSlot(size_t).
    - Changed signature of method Instrument::SwapScriptSlots(uint,uint) to
      Instrument::SwapScriptSlots(size_t,size_t).
    - Changed signature of method Instrument::RemoveScriptSlot(uint) to
      Instrument::RemoveScriptSlot(size_t).
    - Changed signature of method Instrument::ScriptSlotCount() to return
      size_t instead of uint.
    - Changed signature of method Instrument::IsScriptSlotBypassed(uint) to
      Instrument::IsScriptSlotBypassed(size_t).
    - Changed signature of method Instrument::SetScriptSlotBypassed(uint,bool)
      to Instrument::SetScriptSlotBypassed(size_t,bool).
    - Changed signature of method
      Instrument::IsScriptPatchVariableSet(int,String) to
      Instrument::IsScriptPatchVariableSet(size_t,String).
    - Changed signature of method Instrument::GetScriptPatchVariables(int) to
      Instrument::GetScriptPatchVariables(size_t).
    - Changed signature of method
      Instrument::GetScriptPatchVariable(int,String) to
      Instrument::GetScriptPatchVariable(size_t,String).
    - Changed signature of method
      Instrument::SetScriptPatchVariable(int,String,String) to
      Instrument::SetScriptPatchVariable(size_t,String,String).
    - Changed signature of method
      Instrument::UnsetScriptPatchVariable(int,String) to
      Instrument::UnsetScriptPatchVariable(ssize_t,String).
    - Fixed iterator invalidation (i.e. crash) caused by adding / removing
      samples (only triggered if now deprecated File::GetFirstSample() /
      File::GetNextSample() methods were still used).

  * src/SF.cpp, src/SF.h:
    - File::DeleteInstrument(): Fix clang sanatizer warning.

  * src/DLS.cpp, src/DLS.h:
    - Use GetSubChunkAt() instead of GetFirstSubChunk() / GetNextSubChunk() in
      entire DLS.cpp file.
    - Use GetSubListAt() instead of GetFirstSubList() / GetNextSubList() in
      entire DLS.cpp file.
    - Added method Instrument::GetRegionAt().
    - Marked methods Instrument::GetFirstRegion() and
      Instrument::GetNextRegion() as deprecated.
    - Use GetRegionAt() instead of GetFirstRegion() / GetNextRegion() in entire
      DLS.cpp file.
    - Added method File::GetSample().
    - Marked methods File::GetFirstSample() and File::GetNextSample() as
      deprecated.
    - Use File::GetSample() instead of File::GetFirstSample() /
      File::GetNextSample() in entire DLS.cpp file.
    - Added method Articulator::GetArticulation().
    - Marked methods Articulator::GetFirstArticulation() and
      Articulator::GetNextArticulation() as deprecated.
    - Added method File::GetInstrument().
    - Marked methods File::GetFirstInstrument() and File::GetNextInstrument()
      as deprecated.
    - Added method Instrument::CountRegions().
    - Fixed iterator invalidation (i.e. crash) caused by adding / removing
      samples (only triggered if now deprecated File::GetFirstSample() /
      File::GetNextSample() methods were still used).

  * src/RIFF.cpp, src/RIFF.h:
    - Chunk::LoadChunkData(): Fix clang sanatizer warning.
    - List::LoadSubChunks(): Fix potential garbage data access if reading a
      RIFF chunk ID failed.
    - Added methods File::IsIOPerThread() and File::SetIOPerThread(bool); the
      latter allows to automatically use a separate file I/O stream state for
      each thread.
    - Added method List::GetSubChunkAt().
    - Added method List::GetSubListAt().
    - Marked methods List::GetFirstSubChunk(), List::GetNextSubChunk(),
      List::GetFirstSubList() and List::GetNextSubList() as deprecated.
    - Use GetSubListAt() instead of GetFirstSubList() / GetNextSubList() in
      entire RIFF.cpp file.

Version 4.3.0 (9 May 2021)

  * general changes:
    - Require at least a C++11 compliant compiler.
    - Require some UUID generating function by underlying system.

  * src/gig.cpp, src/gig.h:
    - GIG FORMAT EXTENSION: Added attributes DimensionRegion::LFO1WaveForm,
      DimensionRegion::LFO2WaveForm and DimensionRegion::LFO3WaveForm, which
      allow to define override LFOs' wave form (e.g. saw or square instead of
      the default wave form which was always sine in the original
      Gigasampler/GigaStudio software).
    - GIG FORMAT EXTENSION: Added attributes DimensionRegion::LFO1Phase,
      DimensionRegion::LFO2Phase and DimensionRegion::LFO3Phase, which allow to
      move the start point horizontally of the LFOs' waves (0�� ... 360��).
    - GIG FORMAT EXTENSION: Added attribute DimensionRegion::LFO3FlipPhase
      (the original Gigasampler/GigaStudio software only had that flip phase
      option for LFO1 and LFO2).
    - Added methods DimensionRegion::UsesAnyGigFormatExtension(),
      Region::UsesAnyGigFormatExtension(),
      Instrument::UsesAnyGigFormatExtension() and
      File::UsesAnyGigFormatExtension() (however only as private methods yet,
      see comments on methods why).
    - GIG FORMAT EXTENSION: added LinuxSampler specific filter type
      implementations to enum vcf_type_t: vcf_type_lowpass_1p,
      vcf_type_lowpass_2p, vcf_type_lowpass_4p, vcf_type_lowpass_6p,
      vcf_type_highpass_1p, vcf_type_highpass_2p, vcf_type_highpass_4p,
      vcf_type_highpass_6p, vcf_type_bandpass_2p, vcf_type_bandreject_2p.
    - Compatibility fix: GigaStudio always expects 128 '3gnm' RIFF chunks
      (patch by Ivan Maguidhir).
    - Compatibility fix: GigaStudio 3 expects '3dnm' and '3ddp' RIFF chunks
      (original patch by Ivan Maguidhir).
    - Region::DeleteDimensionZone() and Region::SplitDimensionZone(): Fixed
      dimensions being in different order after deleting a dimension zone.
    - Script: Generate a persistent UUID for each script.
    - GIG FORMAT EXTENSION: Added support for script 'patch' variables and
      accordingly added new methods to Instrument class:
      IsScriptPatchVariableSet(), GetScriptPatchVariables(),
      GetScriptPatchVariable(), SetScriptPatchVariable(),
      UnsetScriptPatchVariable(); stored persistently as new 'SCPV' RIFF chunk
      as child of our '3LS ' list chunk on Instrument level.
    - Fixed undefined behaviour when modifying script slots on an instrument
      that had been cloned and not been saved yet (e.g. unintended modification
      of original instrument's script slots, and crash on Instrument destruction
      due to double free of pScriptRefs).

  * src/Serialization.cpp, src/Serialization.h:
    - Fixed broken Archive(RawData) constructor which always threw an
      Exception.
    - Added built-in support for C++ String objects (a.k.a. std::string
      from the STL) and bumped Srx format version to 1.1 for that reason.
    - Fixed assertion fault on some systems if a member variable defined was
      serialized which was declared as size_t or ssize_t data type.
    - Added new method Archive::operation() which allows applications to
      distinguish between serialization vs. deserialization in their
      serialize() method implementations.
    - Added built-in support for C++ Array<> objects (a.k.a. std::vector from
      the STL).
    - Member offsets are now signed and for (newly added support of) member
      variables on the heap -1 is always used as offset instead.
    - Added built-in support for C++ Set<> objects (a.k.a. std::set from the
      STL).
    - DataType: Added optional 2nd custom type name.
    - Added built-in support for C++ Map<> objects (a.k.a. std::map from the
      STL).

  * src/helper.h:
    - Fix compile error with GCC 9 due to ignored result value of vasprintf()
      function call.

  * src/tools/gigdump.cpp:
    - Print dimension region properties LFO1WaveForm, LFO2WaveForm,
      LFO3WaveForm, LFO1Phase, LFO2Phase, LFO3Phase, LFO1FlipPhase,
      LFO2FlipPhase and LFO3FlipPhase.

Version 4.2.0 (25 Jul 2019)

  * general changes:
    - Added MSVC build support (anonymous patch from mailing list).
    - Introduced CMake build support (yet constrained for building with MSVC)
      (anonymous patch from mailing list).
    - Fix: Don't automatically delete RIFF chunks from DLS/gig classes'
      destructors. Added new virtual method DeleteChunks() to those classes
      for this which must be explicitly called instead to remove their RIFF
      chunks.
    - Fix: Many methods of DLS/gig classes assumed a RIFF chunk read position
      of zero; which is unsafe per se.
    - Added C++11 "override" keyword where appropriate.
    - Fixed crash in RIFF, DLS and gig classes which occurred on certain
      of their actions when not passing a progress_t callback structure.

  * 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).
    - GIG FORMAT EXTENSION: Added attribute
      DimensionRegion::NoNoteOffReleaseTrigger which allows to disable the
      regular behaviour of playing release trigger sample on MIDI note-off
      events.
    - Introduced support for writing extension files (.gx01, .gx02, ...)
      (original patch by Ivan Maguidhir).
    - Many gig classes derive now from DLS::Storage (see DLS changes below).
    - Added File::GetRiffFile() method.

  * src/DLS.cpp, src/DLS.h:
    - File: Fixed implicitly allocated RIFF::File object never been freed.
    - Added new abstract interface base class DLS::Storage which is derived by
      the respective classes for implementing (the old) UpdateChunks() and the
      new DeleteChunks() method.
    - Added File::GetRiffFile() method.

  * src/sf2.cpp, src/sf2.h:
    - Added Sample::GetFile() method.
    - Added File::GetRiffFile() method.

  * 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.
    - Fixed comparision logic bug
    - Fixed memory leak in DataType::customTypeName().

  * src/RIFF.cpp, src/RIFF.h:
    - Fix: Calling File::SetMode() left an undefined file handle on Windows and
      caused a resource leak
    - Avoid compiler warning when building for 32 bit windows.
    - Added new method progress_t::subdivide().
    - Fix: API doc comment for Chunk::GetFilePos() was completely wrong.
    - progress_t: Added a 2nd (overridden) progress_t::subdivide() method which
      allows a more fine graded control into which portions the subtasks are
      divided to.

  * 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
      VCFVelocityScale parameter when no cutoff controller was defined
    - support for the gig v3 feature to have a number of dimension
      splits not equal to a power of two
    - added write support (highly experimental)

  * src/DLS.cpp, src/DLS.h:
    - fixed loading of Articulation Connections (<artl> list chunks were
      seeked instead of ordinary <artl> data chunks)
    - added write support (highly experimental)

  * src/RIFF.cpp, src/RIFF.h:
    - added write support
    - Chunk::LoadChunkData() can now be called again to resize the buffer
      after a Chunk::Resize() and before the File::Save() call to allow
      placing the new data in the chunk's write buffer and perform the
      resize and write operations in one rush

  * src/gigdump.cpp:
    - fixed to show the correct amount of dimension regions instead of 32
      (patch by James Wylder)

  * src/dlsdump.cpp:
    - show for every region the name of the referenced sample
    - show file name in quotation marks

Version 2.0.2 (15 Aug 2005)

  * packaging changes:
    - require automake (>= 1.5) for 'make -f Makefile.cvs'
      (mandatory for 'dist-bzip2' automake option)

  * src/gig.cpp, src/gig.h:
    - support for gig v3 multi-file format (.gig, .gx01, .gx02, ...),
      the extension files are read automatically when the samples are
      loaded
    - fixed the 24 bit decompression, the result should now be exact
      instead of an approximation
    - added VCFCutoffControllerInvert parameter and GetVelocityCutoff
      function to DimensionRegion

  * src/DLS.cpp, src/DLS.h:
    - the upper bits of the pool table indices are read (used as
      extension file numbers for gig v3)

  * src/RIFF.cpp, src/RIFF.h:
    - the file name is remembered in the RIFF::File object

Version 2.0.1 (12 Jun 2005)

  * packaging changes:
    - include debian/ directory on 'make dist'
    - create a bzip2 tarball on 'make dist'

  * src/gigextract.cpp:
    - show also version of libsndfile or build version of libaudiofile when
      using the -v switch
    - fixed mutual link dependency to libsndfile / libaudiofile

  * src/gig.cpp, src/gig.h:
    - added DimensionRegion::GetVelocityRelease function

Version 2.0.0 (9 May 2005)

  * packaging changes:
    - fixed conditional linkage of either libsndfile or libaudiofile
      (if none of the two exist, configure script will abort)
    - man pages are now auto generated with the correct libgig version

  * src/gig.cpp, src/gig.h:
    - experimental support for Gigasampler v3 format;
      64 bit file offsets are truncated to 32 bit, 24 bit samples are
      truncated to 16 bit, up to 8 dimensions are read, additional
      articulation informations are ignored at the moment
      (patch by Andreas Persson)
    - added some file format compatibility checks
    - fixed vcf_type_lowpassturbo value (vcf_type_lowpassturbo was actually
      never used, because the necessary check was made before
      initialization)
    - fixed crossfade points order (structure for big endian and little
      endian systems was interchanged)
    - fixed some memory leaks (patch by 'Gene', a.k.a Anders Alm)
    - fixed crash which occured when patches did not have a sample assigned
      to their region or dimension region (patch by Andreas Persson)
    - support for compressed mono samples
    - experimental support for compressed 24 bit samples
    - fixed decompression on big-endian CPUs
    - fixed decompression bug that truncated the last block of samples
    - external decompression buffers can now be used for streaming samples
      to avoid race conditions in case of multiple streaming threads
    - added pre-calculated sample attenuation parameter
    - added v3 "random" and "round robin" dimensions
    - implemented progress indicator callback mechanism for loading
      instruments and samples
    - added functions libraryName() and libraryVersion()

  * src/DLS.cpp, src/DLS.h:
    - fixed File constructor which caused variable File::Instruments always
      to be zero
    - added functions libraryName() and libraryVersion()

  * src/RIFF.cpp, src/RIFF.h:
    - fixed method List::LoadSubChunks() which did not restore the original
      position within the body of the given list chunk
    - added functions libraryName() and libraryVersion()

  * src/rifftree.cpp:
    - added command line switch -v to show rifftree's revision and the used
      libgig version

  * src/dlsdump.cpp:
    - added command line switch -v to show dlsdump's revision and the used
      libgig version

  * src/gigdump.cpp:
    - added output of UnityNote, FineTune, Gain, SampleStartOffset an
      LoopPlayCount
    - added command line switch -v to show gigdump's revision and the used
      libgig version

  * src/gigextract.cpp:
    - support for compressed mono samples and compressed 24 bit samples
    - added command line switch -v to show gigextract's revision and the
      used libgig version

Version 1.0.0 (26 Nov 2004)

  * packaging changes:
    - renamed 'libgig.pc.in' -> 'gig.pc.in' and renamed pkg-config lib name
      'libgig' -> 'gig' as it's common practice to omit the 'lib' prefix
    - fixed man pages automake install rule (which didn't work on Mandrake,
      SuSE and Fedora)
    - fixed generation of Doxygen API documentation (now also included in
      RPM and Debian packages)

  * src/gig.cpp, src/gig.h:
    - fixed / improved accuracy of all three velocity to volume
      transformation functions a.k.a. 'nonlinear','linear','special'
      (patch by Andreas Persson)
    - denormals are filtered from the velocity to volume tables
    - bugfix for dimension region switching (wrong handling of the release
      trigger dimension, no bit range check for dimensions of split type
      'split_type_bit')
    - fixed panorama value in DimensionRegion (invalid conversion from
      signed 7 bit to signed 8 bit)
    - added class attribute 'Layers' to class 'gig::Region'
    - symbol prototyping of gig::Region (fixes build failure with qsampler)

  * src/gigextract.cpp:
    - added support for libsndfile (if libaudiofile and libsndfile are
      available then libsndfile is preferred)

  * src/gigdump.cpp:
    - added printout for dimension informations (amount, type, bits, zones)
    - added printout for velocity response curve parameters
    - added printout for crossfade definitions
    - added printout for panorama value for each DimensionRegion
    - replaced printout of DLS Region layer by printout of amount of
      Gigasampler layers

Version 0.7.1 (2 Jul 2004)

  * packaging changes:
    - added libgig.spec and libgig.pc package configurations for generating
      Redhat packages
    - header files included on installation.
    - autotools-generated files removed from CVS repository.
    - added support for generating Debian packages
    - version of shared library can be set in configure.in

Version 0.7.0 (3 May 2004)

  * general changes:
    - various big endian specific corrections
      (successfully tested now on PPC)
    - minor adjustments to avoid compile errors on some systems
      (using now pow() instead of powl() and --pedantic g++ compiler switch)
    - libtoolized the library
    - added man pages for the command line tools
      (gigextract, gigdump, dlsdump, rifftree)

  * src/gig.cpp, src/gig.h:
    - fixed bug in decompression algorithm which caused it not to detect
      the end of a stream
    - added method GetVelocityAttenuation() to class 'DimensionRegion' which
      takes the MIDI key velocity value as an argument and returns the
      appropriate volume factor (0.0 ... 1.0) for the sample to be played
      back, the velocity curve transformation functions used for this are
      only an approximation so far
    - fixed class attributes 'Sample::LoopStart', 'Sample::LoopEnd' and
      'Sample::LoopSize' which reflected wrong values
    - class attributes 'Sample::LoopStart' and 'Sample::LoopEnd' are now
      measured in sample points instead of byte offset
    - renamed misleading attribute name 'Sample::MIDIPitchFraction' to
      'Sample::FineTune'
    - added class attribute 'Sample::LoopSize'
    - added method GetInstrument(uint index) to class 'File'
    - added ReadAndLoop() method to class 'Sample' which is an extension to
      the normal Read() method to honor the sample's looping information
      while streaming from disk
    - changed interface for 'attenuation_ctrl_t', 'eg1_ctrl_t' and
      'eg2_ctrl_t': replaced this huge enumeration by a structure which
      reflects the MIDI controller number in case of an ordinary control
      change controller (this saves a huge switch-case block in the
      application of the library user)
    - renamed following attributes in class 'DimensionRegion':
      'AttenuationContol' -> 'AttenuationController',
      'InvertAttenuationControl' -> 'InvertAttenuationController',
      'AttenuationControlTreshold' -> 'AttenuationControllerThreshold'
    - minor fix in API documentation for method GetVelocityAttenuation() in
      class 'DimensionRegion'

  * src/RIFF.cpp, src/RIFF.h:
    - added additional API documentation
    - minor fix in Chunk::Read() method (only a minor efficiency issue)

  * src/gigdump.cpp:
    - added printout of samples' looping informations

Version 0.6.0 (3 Nov 2003)

  * initial release