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)

  * 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

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