Annotation of /libgig/trunk/ChangeLog

Version CVS HEAD (?)

  * 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)

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
1	schoenebeck	1050	Version CVS HEAD (?)
2
3			* packaging changes:
4			- ported to Windows using native Windows functions for file IO
5			(provided Dev-C++ + mingw project file)
6	schoenebeck	1079	- only export relevant files to Doxygen API documentation
7	schoenebeck	1050
8	persson	1070	* src/gig.cpp, src/gig.h:
9			- custom velocity splits now works for gig v3 files too
10			- added support for custom splits points for other dimensions than
11			velocity (gig v3 feature)
12	persson	1076	- added "smart midi" and "round robin keyboard" dimensions
13	schoenebeck	1081	- added new method File::DeleteGroupOnly() which only deletes the given
14			group but moves all its members to another group, the other method,
15			that is File::DeleteGroup() now removes not just the group, but also
16			all the samples that belong to that group
17	schoenebeck	1083	- fixed crash which occured on interfering File::DeleteSample() and
18			File::GetNextSample() calls (due to iterator invalidation)
19	persson	1070
20	schoenebeck	933	Version 3.1.0 (24 Nov 2006)
21	persson	858
22	capela	867	* packaging changes:
23			- changed deprecated copyright attribute to license;
24			added ldconfig to post-(un)install steps on libgig.spec (RPM)
25	persson	902
26	persson	858	* src/gig.cpp, src/gig.h:
27			- added support for more than one set of custom velocity splits
28			inside a region (for example different velocity split levels for
29			pedal up and pedal down)
30	persson	864	- sample loop parameters are now taken from the DimensionRegion
31			instead of the wave chunk
32			- keyswitching dimension is changed from split type "normal" to
33			"bit"
34	persson	902	- real support for 24 bit samples - samples are not truncated to
35			16 bits anymore
36			- support for reading of ".art" files. (Merging of .art and .gig
37			files are not implemented yet.)
38	persson	918	- several fixes for the write support
39	schoenebeck	929	- support for sample groups added
40	persson	858
41	persson	918	* src/DLS.cpp, src/DLS.h:
42	persson	902	- support for reading of ".art" files
43	persson	918	- removed incorrect use of memccpy in the write support (patch by
44			Jeremy Kerr)
45			- several fixes for the write support
46	persson	902
47			* src/gigextract.cpp:
48			- real support for 24 bit samples
49
50	schoenebeck	916	* src/gigdump.cpp:
51			- print global file informations
52	schoenebeck	929	- print sample groups
53	schoenebeck	916
54	schoenebeck	917	* general changes:
55			- added CPPUnit test cases (at the moment primarily for automatic check
56			of Gigasampler write support)
57
58	schoenebeck	854	Version 3.0.0 (28 Apr 2006)
59	persson	773
60	schoenebeck	780	* general changes:
61	schoenebeck	809	- added write support (that is for creating and modifying RIFF, DLS and
62			gig files)
63			- loading DLS and gig files is now much more permissive, DLS and gig
64			files are now loaded even if mandatory RIFF chunks are missing
65	persson	834	- fixed some memory management errors, one of them was causing a
66			crash when a multi-file gig was deallocated
67	schoenebeck	780
68	persson	773	* src/gig.cpp, src/gig.h:
69			- fixed the GetVelocityCutoff function, it wasn't always using the
70			VCFVelocityScale parameter when no cutoff controller was defined
71	persson	774	- support for the gig v3 feature to have a number of dimension
72			splits not equal to a power of two
73	schoenebeck	809	- added write support (highly experimental)
74	persson	773
75	schoenebeck	800	* src/DLS.cpp, src/DLS.h:
76			- fixed loading of Articulation Connections (<artl> list chunks were
77			seeked instead of ordinary <artl> data chunks)
78			- added write support (highly experimental)
79
80			* src/RIFF.cpp, src/RIFF.h:
81			- added write support
82			- Chunk::LoadChunkData() can now be called again to resize the buffer
83			after a Chunk::Resize() and before the File::Save() call to allow
84			placing the new data in the chunk's write buffer and perform the
85			resize and write operations in one rush
86
87	schoenebeck	809	* src/gigdump.cpp:
88			- fixed to show the correct amount of dimension regions instead of 32
89			(patch by James Wylder)
90
91	schoenebeck	804	* src/dlsdump.cpp:
92			- show for every region the name of the referenced sample
93			- show file name in quotation marks
94
95	schoenebeck	732	Version 2.0.2 (15 Aug 2005)
96	schoenebeck	652
97			* packaging changes:
98			- require automake (>= 1.5) for 'make -f Makefile.cvs'
99			(mandatory for 'dist-bzip2' automake option)
100
101	persson	666	* src/gig.cpp, src/gig.h:
102			- support for gig v3 multi-file format (.gig, .gx01, .gx02, ...),
103			the extension files are read automatically when the samples are
104			loaded
105	persson	695	- fixed the 24 bit decompression, the result should now be exact
106			instead of an approximation
107	persson	728	- added VCFCutoffControllerInvert parameter and GetVelocityCutoff
108			function to DimensionRegion
109	persson	666
110			* src/DLS.cpp, src/DLS.h:
111			- the upper bits of the pool table indices are read (used as
112			extension file numbers for gig v3)
113
114			* src/RIFF.cpp, src/RIFF.h:
115			- the file name is remembered in the RIFF::File object
116
117	schoenebeck	632	Version 2.0.1 (12 Jun 2005)
118	schoenebeck	549
119	schoenebeck	634	* packaging changes:
120			- include debian/ directory on 'make dist'
121			- create a bzip2 tarball on 'make dist'
122
123	schoenebeck	549	* src/gigextract.cpp:
124			- show also version of libsndfile or build version of libaudiofile when
125			using the -v switch
126	schoenebeck	608	- fixed mutual link dependency to libsndfile / libaudiofile
127	schoenebeck	549
128	persson	613	* src/gig.cpp, src/gig.h:
129			- added DimensionRegion::GetVelocityRelease function
130
131	schoenebeck	530	Version 2.0.0 (9 May 2005)
132	schoenebeck	317
133	schoenebeck	383	* packaging changes:
134			- fixed conditional linkage of either libsndfile or libaudiofile
135			(if none of the two exist, configure script will abort)
136	schoenebeck	518	- man pages are now auto generated with the correct libgig version
137	schoenebeck	383
138	schoenebeck	317	* src/gig.cpp, src/gig.h:
139			- experimental support for Gigasampler v3 format;
140			64 bit file offsets are truncated to 32 bit, 24 bit samples are
141	schoenebeck	347	truncated to 16 bit, up to 8 dimensions are read, additional
142			articulation informations are ignored at the moment
143			(patch by Andreas Persson)
144	schoenebeck	317	- added some file format compatibility checks
145	schoenebeck	345	- fixed vcf_type_lowpassturbo value (vcf_type_lowpassturbo was actually
146			never used, because the necessary check was made before
147			initialization)
148			- fixed crossfade points order (structure for big endian and little
149			endian systems was interchanged)
150	schoenebeck	355	- fixed some memory leaks (patch by 'Gene', a.k.a Anders Alm)
151	schoenebeck	352	- fixed crash which occured when patches did not have a sample assigned
152			to their region or dimension region (patch by Andreas Persson)
153	persson	365	- support for compressed mono samples
154			- experimental support for compressed 24 bit samples
155			- fixed decompression on big-endian CPUs
156			- fixed decompression bug that truncated the last block of samples
157	schoenebeck	384	- external decompression buffers can now be used for streaming samples
158			to avoid race conditions in case of multiple streaming threads
159	persson	406	- added pre-calculated sample attenuation parameter
160	persson	437	- added v3 "random" and "round robin" dimensions
161	schoenebeck	515	- implemented progress indicator callback mechanism for loading
162			instruments and samples
163	schoenebeck	518	- added functions libraryName() and libraryVersion()
164	schoenebeck	317
165	schoenebeck	518	* src/DLS.cpp, src/DLS.h:
166	schoenebeck	515	- fixed File constructor which caused variable File::Instruments always
167			to be zero
168	schoenebeck	518	- added functions libraryName() and libraryVersion()
169	schoenebeck	515
170	schoenebeck	518	* src/RIFF.cpp, src/RIFF.h:
171	schoenebeck	515	- fixed method List::LoadSubChunks() which did not restore the original
172			position within the body of the given list chunk
173	schoenebeck	518	- added functions libraryName() and libraryVersion()
174	schoenebeck	515
175	schoenebeck	518	* src/rifftree.cpp:
176			- added command line switch -v to show rifftree's revision and the used
177			libgig version
178
179			* src/dlsdump.cpp:
180			- added command line switch -v to show dlsdump's revision and the used
181			libgig version
182
183	schoenebeck	334	* src/gigdump.cpp:
184	schoenebeck	530	- added output of UnityNote, FineTune, Gain, SampleStartOffset an
185			LoopPlayCount
186	schoenebeck	518	- added command line switch -v to show gigdump's revision and the used
187			libgig version
188	schoenebeck	334
189	persson	365	* src/gigextract.cpp:
190			- support for compressed mono samples and compressed 24 bit samples
191	schoenebeck	518	- added command line switch -v to show gigextract's revision and the
192			used libgig version
193	persson	365
194	schoenebeck	315	Version 1.0.0 (26 Nov 2004)
195	schoenebeck	196
196			* packaging changes:
197			- renamed 'libgig.pc.in' -> 'gig.pc.in' and renamed pkg-config lib name
198			'libgig' -> 'gig' as it's common practice to omit the 'lib' prefix
199	schoenebeck	315	- fixed man pages automake install rule (which didn't work on Mandrake,
200			SuSE and Fedora)
201			- fixed generation of Doxygen API documentation (now also included in
202			RPM and Debian packages)
203	schoenebeck	196
204	schoenebeck	231	* src/gig.cpp, src/gig.h:
205			- fixed / improved accuracy of all three velocity to volume
206	schoenebeck	315	transformation functions a.k.a. 'nonlinear','linear','special'
207			(patch by Andreas Persson)
208	schoenebeck	231	- denormals are filtered from the velocity to volume tables
209	schoenebeck	241	- bugfix for dimension region switching (wrong handling of the release
210			trigger dimension, no bit range check for dimensions of split type
211			'split_type_bit')
212	schoenebeck	269	- fixed panorama value in DimensionRegion (invalid conversion from
213			signed 7 bit to signed 8 bit)
214	schoenebeck	282	- added class attribute 'Layers' to class 'gig::Region'
215	schoenebeck	315	- symbol prototyping of gig::Region (fixes build failure with qsampler)
216	schoenebeck	231
217	schoenebeck	220	* src/gigextract.cpp:
218			- added support for libsndfile (if libaudiofile and libsndfile are
219			available then libsndfile is preferred)
220
221	schoenebeck	229	* src/gigdump.cpp:
222			- added printout for dimension informations (amount, type, bits, zones)
223	schoenebeck	231	- added printout for velocity response curve parameters
224	schoenebeck	235	- added printout for crossfade definitions
225	schoenebeck	269	- added printout for panorama value for each DimensionRegion
226	schoenebeck	282	- replaced printout of DLS Region layer by printout of amount of
227			Gigasampler layers
228	schoenebeck	229
229	capela	168	Version 0.7.1 (2 Jul 2004)
230
231			* packaging changes:
232	schoenebeck	192	- added libgig.spec and libgig.pc package configurations for generating
233			Redhat packages
234	capela	168	- header files included on installation.
235			- autotools-generated files removed from CVS repository.
236	schoenebeck	186	- added support for generating Debian packages
237			- version of shared library can be set in configure.in
238
239	schoenebeck	58	Version 0.7.0 (3 May 2004)
240
241			* general changes:
242			- various big endian specific corrections
243			(successfully tested now on PPC)
244			- minor adjustments to avoid compile errors on some systems
245			(using now pow() instead of powl() and --pedantic g++ compiler switch)
246			- libtoolized the library
247			- added man pages for the command line tools
248			(gigextract, gigdump, dlsdump, rifftree)
249
250			* src/gig.cpp, src/gig.h:
251			- fixed bug in decompression algorithm which caused it not to detect
252			the end of a stream
253			- added method GetVelocityAttenuation() to class 'DimensionRegion' which
254			takes the MIDI key velocity value as an argument and returns the
255			appropriate volume factor (0.0 ... 1.0) for the sample to be played
256			back, the velocity curve transformation functions used for this are
257			only an approximation so far
258			- fixed class attributes 'Sample::LoopStart', 'Sample::LoopEnd' and
259			'Sample::LoopSize' which reflected wrong values
260			- class attributes 'Sample::LoopStart' and 'Sample::LoopEnd' are now
261			measured in sample points instead of byte offset
262			- renamed misleading attribute name 'Sample::MIDIPitchFraction' to
263			'Sample::FineTune'
264			- added class attribute 'Sample::LoopSize'
265			- added method GetInstrument(uint index) to class 'File'
266			- added ReadAndLoop() method to class 'Sample' which is an extension to
267			the normal Read() method to honor the sample's looping information
268			while streaming from disk
269			- changed interface for 'attenuation_ctrl_t', 'eg1_ctrl_t' and
270			'eg2_ctrl_t': replaced this huge enumeration by a structure which
271			reflects the MIDI controller number in case of an ordinary control
272			change controller (this saves a huge switch-case block in the
273			application of the library user)
274			- renamed following attributes in class 'DimensionRegion':
275			'AttenuationContol' -> 'AttenuationController',
276			'InvertAttenuationControl' -> 'InvertAttenuationController',
277			'AttenuationControlTreshold' -> 'AttenuationControllerThreshold'
278			- minor fix in API documentation for method GetVelocityAttenuation() in
279			class 'DimensionRegion'
280
281			* src/RIFF.cpp, src/RIFF.h:
282			- added additional API documentation
283			- minor fix in Chunk::Read() method (only a minor efficiency issue)
284
285			* src/gigdump.cpp:
286			- added printout of samples' looping informations
287
288	schoenebeck	11	Version 0.6.0 (3 Nov 2003)
289
290			* initial release