/[svn]/linuxsampler/trunk/ChangeLog
ViewVC logotype

Diff of /linuxsampler/trunk/ChangeLog

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1130 by iliev, Sun Mar 25 18:59:14 2007 UTC revision 4010 by schoenebeck, Thu Dec 23 15:26:02 2021 UTC
# Line 1  Line 1 
1  Version CVS HEAD (?)  Version SVN trunk (?)
2    
3      * general changes:
4        - AbstractEngineChannel: fixed CCs not being forwarded to all
5          VirtualMIDIDevices.
6        - Fix compiler error with release tarball if no Bison installed
7          (SVN version still requires Flex and Bison being installed).
8    
9      * Real-time instrument scripts:
10        - Fix: Do not share compiled instrument scripts among multiple engine
11          channels (sampler parts) as this can lead to crashes and would allow the
12          same global script variables to be accessible from multiple engine
13          channels which would not be the expected behaviour by instrument script
14          authors.
15    
16      * GigaStudio/Gigasampler format engine:
17        - Use libgig's new IO-per-thread feature to avoid file I/O concurrency
18          issues with .gig file.
19        - Use libgig's new method gig::File::GetSample() with method
20          gig::File::CountSamples() instead of now deprecated
21          gig::File::GetFirstSample() / gig::File::GetNextSample() pair.
22        - Use libgig's new method gig::Instrument::GetRegionAt() with method
23          gig::Instrument:CountRegions() instead of now deprecated
24          gig::Instrument::GetFirstRegion() / gig::Instrument::GetNextRegion() pair.
25        - Use libgig's gig::File::GetInstrument() method with method
26          gig::File::CountInstruments() instead of now deprecated
27          gig::File::GetFirstInstrument() / gig::File::GetNextInstrument() pair.
28        - Show a more detailed error message on terminal if an appropriate editor
29          could not be found for a .gig instrument (if there is not any editor then
30          say so, if there is one but not capable to handle the instrument, then
31          make this case clear to the user; in both cases print the expected
32          location for instrument editor plugins).
33    
34      * MIDI driver:
35        - VirtualMidiDevice: added method Reset() which is e.g. intended to be used
36          in "panic" / MIDI "all sound off" / MIDI "all note off" situations.
37        - VirtualMidiDevice: release all notes on MIDI CC #120 and CC #123.
38    
39    Version 2.2.0 (9 May 2021)
40    
41      * general changes:
42        - Fixed compiler error in Pool.h.
43        - Require C++14 compiler support.
44        - Autoconf: Added m4/ax_cxx_compile_stdcxx.m4 macro which is used
45          for checking in configure for C++14 support (as mandatory
46          requirement) and automatically adds compiler argument if required
47          (e.g. -std=C++14).
48        - RTMath: Implemented floating point comparison methods
49          fEqual32(float,float) and fEqual64(double,double) which take the
50          expected floating point tolerances into account.
51        - Added public API C++ class "LFO", which is a cluster class encapsulating
52          all the sampler's LFO implementations to be used by 3rd party applications
53          (e.g. by Gigedit).
54        - Added int math square LFO implementation.
55        - Added int math saw LFO implementation.
56        - Added numeric complex nr sine LFO implementation.
57        - Marked class LFOTriangleDiHarmonic as deprecated
58          (will be removed in future).
59        - Added LFOAll.h which includes all LFO implementation's header files.
60        - Refactored LFO class names and their file names (PulseLFO -> LFOPulse,
61          LFOSawIntMath -> LFOSawIntMathNew, SawLFO -> LFOSawIntMathOld,
62          SineLFO -> LFOSineBuiltinFn, LFOSine -> LFOSineNumericComplexNr,
63          SquareLFO -> LFOSquarePulse and separated the latter to its own header
64          file).
65        - Renamed type LFOSigned -> LFOTriangleSigned.
66        - Renamed type LFOUnsigned -> LFOTriangleUnsigned.
67        - Using now cubic interpolation as resampling algorithm by default; and
68          linear interpolation is deprecated now.
69        - Event:Init(): memset() entire Event::Param union to zero instead of trying
70          to do that for its individual members; the latter became error prone due
71          to the union's growing complexity meanwhile.
72        - EngineChannel: Overhaul of RPN/NRPN related methods: Added new
73          *Rpn*Parameter*() methods as replacement for previous *Rpn*Controller*()
74          methods and marked the old ones as deprecated; and likewise added new
75          *Nrpn*Parameter*() methods as replacement for previous *Nrpn*Controller*()
76          methods and marked those old ones deprecated as well.
77        - Added support for MIDI CC #38 (data entry LSB): this allows higher value
78          resolution for certain (e.g. hard coded) RPN and NRPN parameters.
79        - Implemented support for compressed RPN/NRPN message sequences (that is to
80          allow processing MIDI data entry messages without always having to be
81          preceded strictly by RPN/NRPN parameter selection messages on each value
82          change).
83        - Added support for MIDI CC #96 (data increment) and MIDI CC #97 (data
84          decrement).
85        - Added support for 'null function RPN/NRPN' (which is RPN/NRPN parameter
86          MSB=127 and LSB=127) and which is disabling subsequent data
87          entry/increment/decrement CC messages.
88        - Fixed crash when editing key groups (a.k.a. exclusive groups) with an
89          instrument editor.
90        - Fixed playing noise at the end of a disk stream under certain conditions.
91        - Fixed potential crash with high pitch at end of RAM playback.
92        - Added configure checks whether C++ compiler supports so called
93          'designated initializers'.
94        - Added global backtraceAsString() function for debugging purposes
95          (POSIX systems only, no Windows implementation yet).
96        - Thread class: Added new methods pushCancelable(), popCancelable(), name(),
97          nameOfCaller() and setNameOfCaller().
98        - configure: Always check for availability of pthread_testcancel() and use
99          it if so (previously it was only used if explicitly enabled by configure
100          option).
101        - Thread class: raise compiler warning if pthread_testcancel() is not
102          available, because it can lead to deadlocks.
103        - Mutex class: Implemented optional bug detection and deadlock debugging
104          features.
105        - Ref<> class is now thread safe (as lock-free and wait-free
106          implementation).
107        - Fixed compilation error with Bison >= 3.6.0.
108        - Fixed rare crash when switching between instruments that had instrument
109          scripts loaded.
110        - Allow EffectChain::InsertEffect() as alternative to
111          EffectChain::AppendEffect() (i.e. with index equal to current chain size).
112        - ConstCapacityArray class: Fixed bug in remove() method.
113        - Fixed crash on certain MIDI RPN and NRPN messages that occurred if no
114          real-time instrument script was loaded.
115    
116      * Real-time instrument scripts:
117        - Added method ScriptVM::setExitResultEnabled() which allows to
118          explicitly enable the built-in exit() function to optionally accept
119          one function argument; the value of the passed exit() function
120          argument will then become available by calling
121          VMExecContext::exitResult() after script execution.
122        - 64 bit support for NKSP integer scripts variables (declare $foo).
123        - Variable names, function names and preprocessor condition names must start
124          with a regular character (a-z or A-Z); starting them with a digit or
125          underscore is not allowed.
126        - NKSP parser fix: equal comparison operator "=" and not equal comparison
127          operator "#" must only accept integer operands.
128        - NKSP language: Implemented support for standard units like Hertz, seconds,
129          Bel including support for metric unit prefixes; so one can now e.g.
130          conveniently use numbers in scripts like "5us" meaning "5 microseconds",
131          or e.g. "12kHz" meaning "12 kilo Hertz", or e.g. "-14mdB" meaning
132          "minus 14 Millidecibel", or e.g. "28c" meaning "28 cents" (for tuning).
133        - NKSP language: Introduced "final" operator "!" which is specifically
134          intended for synthesis parameter values to denote that the synthesis
135          parameter value is intended to be the "final" value for that synthesis
136          parameter that should explicitly be used by the engine and thus causing
137          the sampler engine to ignore all other modulation sources for the same
138          synthesis parameter (like e.g. LFO, EG); by simply prefixing a value,
139          variable or formula with this new "!" operator the expression is marked as
140          being "final".
141        - NKSP script editor API: Added support for detecting standard unit tokens
142          and their potential metric prefix token.
143        - NKSP language: Added support for NKSP real number literals and
144          arithmetic operations on them (e.g. "(3.9 + 2.9) / 12.3 - 42.0").
145        - NKSP language: Added support for NKSP real number (floating point) script
146          variables (declare ~foo).
147        - NKSP language: Added support for NKSP real number (floating point) array
148          script variables (declare ?foo[]).
149        - Built-in script function "message()" accepts now real number argument as
150          well.
151        - Added built-in script function "real_to_int()" and its short hand form
152          "int()" for casting from real number to integer in NKSP scripts.
153        - Added built-in script function "int_to_real()" and its short hand form
154          "real()" for casting from integer to real number in NKSP scripts.
155        - Allow built-in exit() function to potentially accept real number type
156          argument as well.
157        - Built-in script functions may have a different return type depending on
158          the arguments passed to the function.
159        - Built-in script function "abs()" optionally accepts and returns real
160          number.
161        - Built-in script functions "min()" and "max()" optionally accept real
162          number arguments and return real number as result in that case.
163        - NKSP VM API: Allow units and 'final'ness to be returned as result from
164          built-in functions (added methods VMFunction::returnUnitType() and
165          VMFunction::returnsFinal() for that purpose which must be implemented by
166          built-in function implementations).
167        - NKSP language: Allow metric unit prefixes of numeric scalar and array
168          variables to be changed freely at runtime (unlike unit types like Hz etc.
169          which are still sticky, parse-time features of variables which cannot be
170          changed at runtime for the intentional sake of determinism).
171        - NKSP language: 'final' values are prohibited for array variables for now
172          (attempt causes a parsers error).
173        - NKSP language: expressions with unit types (e.g. Hz) are prohibited for
174          conditions of runtime control structures like if(), while(), select()
175          (attempt causes a parser error).
176        - NKSP VM API: Allow built-in functions to perform their own, individual
177          parse time checks of arguments going to be passed to the function at
178          runtime (added method VMFunction::checkArgs() for that purpose).
179        - NKSP language: raise parser warning if only one operand of binary
180          operators (like logical 'or' comparison) contain a 'final' value (because
181          it would always yield in a 'final' result in such cases).
182        - NKSP language: Allow comparison (=, #, <, >, <=, >=) of values with
183          different metric unit prefixes, which will behave as expected (e.g.
184          result of expression '1000us < 2ms' is true).
185        - NKSP language: Allow adding values with different metric unit prefixes
186          (e.g. result of expression '100Hz + 5kHz' is '5100Hz').
187        - NKSP language: Allow subtracting values with different metric unit
188          prefixes (e.g. result of expression '1ms - 20us' is '980us').
189        - NKSP language: Allow multiplying with any metric unit prefixes
190          (e.g. result of expression '2k * 3ms' is '6s'), however multiplications
191          with unit types on both sides (e.g. '2s * 2s') is still prohibited since
192          we don't have any considerable practical use for a term like '4s^2'
193          (hence any attempt multiplying two unit types still causes parser error).
194        - NKSP language: Allow dividing by any metric unit prefixes and allow
195          division of same unit type on both sides (e.g. expression '8kHz / 1000Hz'
196          yields in unit free result '8'). So this is now a way to cast units away
197          e.g. for passing the result to other expressions, certain function calls
198          or variables which are not accepting any units (or that specific unit).
199        - NKSP language: integer arrays and real number arrays can now be converted
200          to strings (e.g. for dumping their content with message() calls for
201          script debugging purposes).
202        - NKSP language: expressions and variables with units are now correctly
203          casted to strings (e.g. with message() calls).
204        - NKSP language: comparing real numbers for equalness (e.g. '~foo = 3.1') or
205          unequalness (e.g. '~foo # 3.1') is now less strict and takes the expected
206          floating point tolerances into account.
207        - NKSP VM API: Added methods VMScalarNumberExpr::evalCastInt() and
208          VMScalarNumberExpr::evalCastReal().
209        - NKSP VM API: Added base class 'VMNumberArrayExpr' for classes
210          'VMIntArrayExpr' and 'VMRealArrayExpr'.
211        - NKSP VM API: replaced all unitPrefix() (parse time) methods by
212          unitFactor() (runtime) methods.
213        - Built-in function "exit()" supports now returning units and 'final'ness
214          for test cases.
215        - The following built-in functions support now units as well: "abs()",
216          "random()", "inc()", "dec()", "in_range()", "min()", "max()",
217          "real_to_int()", "int()", "int_to_real()" and "real()".
218        - Built-in functions "array_equal()", "search()" and "sort()" support now
219          real number arrays (correctly) as well.
220        - Added individual parse time checks of arguments to be passed to built-in
221          functions "random()", "inc()", "dec()", "in_range()", "min()", "max()",
222          "array_equal()" and "search()" specific for their individual purposes.
223        - NKSP VM refactoring: Renamed all methods, functions and classes matching
224          pattern *ScalarNumber* to simply *Number* (that is i.e. classes
225          VMScalarNumberExpr -> VMNumberExpr, ScalarNumberExpr -> NumberExpr,
226          ScalarNumberVariable -> NumberVariable, ScalarNumberBinaryOp ->
227          NumberBinaryOp, VMScalarNumberResultFunction -> VMNumberResultFunction,
228          method VMExpr::asScalarNumberExpr() -> VMExpr::asNumber(), function
229          isScalarNumber() -> isNumber()).
230        - NKSP VM API: Added 4 overridden methods to class VMNumberExpr:
231          evalCastInt(MetricPrefix_t), evalCastInt(MetricPrefix_t,MetricPrefix_t),
232          evalCastReal(MetricPrefix_t), evalCastReal(MetricPrefix_t,MetricPrefix_t)
233          as convenient methods for automatically converting values to expected
234          metric value basis.
235        - Built-in function "wait()" accepts now both integers and real numbers as
236          argument.
237        - NKSP VM API cleanup: Get rid of legacy method
238          VMFunction::argType(vmint iArg) which was already superseded by its new
239          replacement VMFunction::acceptsArgType(vmint iArg, ExprType_t type).
240        - NKSP parser: if wrong argument type was passed to a built-in function and
241          that built-in function accepts more than one data type for the argument,
242          then show all supported data types as parser error message.
243        - Built-in function "play_note()" accepts now real numbers and seconds as
244          unit type as well for its 3rd and 4th function arguments.
245        - The following built-in functions accept now real numbers as well for their
246          2nd function argument: "change_vol()", "change_tune()", "change_cutoff()",
247          "change_attack()", "change_decay()", "change_release()",
248          "change_sustain()", "change_cutoff_attack()", "change_cutoff_decay()",
249          "change_cutoff_sustain()", "change_cutoff_release()",
250          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
251          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
252          "change_pan_time()", "fade_in()", "fade_out()", "change_play_pos()".
253        - Fixed built-in function "change_play_pos()" not having accepted metric
254          prefixes at all.
255        - Fixed the following built-in functions having misinterpreted values given
256          with unit type (for their 2nd argument) as if they were relative values
257          (that is as if they were passed without a unit type): "change_attack()",
258          "change_decay()", "change_release()", "change_cutoff_attack()",
259          "change_cutoff_decay()", "change_cutoff_release()".
260        - Fixed the following built-in functions having applied completely wrong
261          'final' values: "change_sustain()", "change_cutoff_sustain()" (since the
262          respective EGs being their modulation sink assume uint data type with
263          value range 0..1000 instead of 0.0..1.0.
264        - Added individual parse-time checks of function arguments for the following
265          built-in functions: "play_note()", "note_off()", "set_event_mark()",
266          "delete_event_mark()", "by_marks()", "change_cutoff()", "change_attack()",
267          "change_decay()", "change_release()", "change_cutoff_attack()",
268          "change_cutoff_decay()", "change_cutoff_release()",
269          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
270          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()" and
271          "change_pan_time()".
272        - Don't abort function call if unit type was used and at the same time
273          'final' operator was omitted for the primary value argument of the
274          following built-in functions: "change_cutoff()", "change_attack()",
275          "change_decay()", "change_release()", "change_cutoff_attack()",
276          "change_cutoff_decay()", "change_cutoff_release()",
277          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
278          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
279          "change_pan_time()", instead imply 'final'ness at runtime and raise an
280          appropriate parser warning at parse time.
281        - Added built-in real number functions "round()", "ceil()", "floor()",
282          "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()", "sin()",
283          "cos()", "tan()", "asin()", "acos()", "atan()".
284        - Added built-in script real number constant "~NI_MATH_PI".
285        - Added built-in script real number constant "~NI_MATH_E".
286        - NKSP language: Allow unary '+' operator.
287        - Added built-in script functions "msb()" and "lsb()".
288        - NKSP language: Added support for RPN event handler
289          ("on rpn ... end on" in instrument scripts).
290        - NKSP language: Added support for NRPN event handler
291          ("on nrpn ... end on" in instrument scripts).
292        - Added built-in read-only variables "$RPN_ADDRESS" and "$RPN_VALUE" which
293          may be read from the new RPN/NRPN script handlers to get the (N)RPN
294          parameter that had been changed and its new value.
295        - Added built-in const variables "$NI_CB_TYPE_RPN" and "$NI_CB_TYPE_NRPN"
296          which are identifying the new (N)RPN handlers as such at script runtime.
297        - Implemented built-in script function "set_rpn()".
298        - Implemented built-in script function "set_nrpn()".
299        - Fix: built-in functions returning an array type were broken and caused a
300          crash when the built-in function's (supposed to be array) result value was
301          used by the script VM.
302        - Removed upper value constraint for 2nd argument of built-in functions
303          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
304          "change_pitch_lfo_freq()","change_reso()", "change_cutoff()",
305          "change_amp_lfo_depth()", "change_cutoff_lfo_depth()" and
306          "change_pitch_lfo_depth()", to allow e.g. passing value 2000000 to double
307          the LFO frequency / resonance / cutoff frequency.
308        - Reduced code involved for parsing NKSP variable declarations by using 2
309          generalized grammar rules with optional components (i.e. optional value
310          assignment and optional variable qualifiers) instead of previous linear
311          combinations of grammar rules, which also fixes some edge case.
312        - NKSP language parser: track code block locations also by a) raw byte
313          position in NKSP source code string and b) length of that code block in
314          bytes (along to the already existing code block tracking by line/column);
315          and added appropriate new members to public C++ API classes like
316          'firstByte' and 'lengthBytes' to class VMSourceToken and struct CodeBlock.
317        - NKSP language: Added support for 'patch' variable qualifier (capture their
318          locations and allow replacement of their assignment expression via VM C++
319          API).
320        - Fixed incorrect EG times if standard measuring unit was passed to built-in
321          functions "change_attack()", "change_decay()" or "change_release()".
322        - Fixed intermediate function result values never having reflected any
323          standard measuring unit type.
324        - Fixed re-entrant issue with function calls which caused wrong result
325          values if the same function was called multiple times in a term
326          (specifically if metric prefixes were used).
327        - NKSP language: Just throw a warning, not an error if an array variable of
328          size zero was declared.
329        - NKSP language: Allow omitting explicit array size on array variable
330          declaration if combined with immediate value assignment
331          (e.g. declare %foo[] := ( 1, 2, 3 ) ).
332        - NKSP language: emit warning if an array variable was declared with bigger
333          array size than amount of initial values been assigned, and initialize the
334          missing array elements with zero in this case.
335        - Fixed built-in NKSP exit() function to behave as return statement.
336        - NKSP parser: Fixed crash if unary '-' operator was used on a non-number
337          data type.
338        - NKSP VM: Fixed the "release" handler being executed too often under
339          certain situations if polyphonic data was passed from "note" handler to
340          "release" handler.
341        - Fixed memory leak in NKSP parser: string tokens were allocated as C
342          strings and never freed.
343        - Fixed incorrect polyphonic data transfer from wrong note handler to
344          release handler; which also fixes no release handler being executed
345          sometimes, and due to the latter it also fixes potential crashes as some
346          polyphonic script events were never released and the engine hence was
347          running out of free script events.
348        - Fixed crash when handling array results of built-in functions
349          (e.g. "num_elements(by_marks($MARK_1)").
350        - NKSP VM: Fixed dead note events not been removed from user's event groups
351          (i.e. causing incorrect behaviour of built-in NKSP functions by_marks()
352          and set_event_mark() after max. size of event group list was exhausted).
353    
354      * test cases:
355        - Fixed compiler errors in test cases.
356        - Updated README for how to compile & run test cases.
357        - Updated test case
358          MutexTest::testDoubleLockStillBlocksConcurrentThread() to latest
359          expected behaviour of the Mutex class implementation (recursive
360          mutex type).
361        - Added test cases for NKSP core language aspects and core built-in
362          functions.
363        - Fixed thread tests segfaulting on Linux.
364        - NKSP: Added real number test cases for built-in functions exit(),
365          int_to_real(), real(), real_to_int() and int(), as well as for the
366          plus, minus and negate language operators.
367        - Added massive amount of NKSP test cases for standard measuring units and
368          'final' operator usage cases.
369        - Added NKSP test cases for (floating point tolerance aware) real number
370          equalness / unequalness comparison.
371        - Added NKSP int array and real array tests for value assignment and
372          initialization of arrays.
373        - Added NKSP test cases for built-in functions "round()", "ceil()",
374          "floor()", "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()",
375          "sin()", "cos()", "tan()", "asin()", "acos()", "atan()".
376        - Added NKSP test cases for unary '+' operator.
377        - Added NKSP test cases for core built-in variables.
378        - Added thorough NKSP test cases for variable declarations.
379    
380      * GigaStudio/Gigasampler format engine:
381        - LFOTriangleIntMath and LFOTriangleIntAbsMath: Fixed FlipPhase=true
382          behaviour for start_level_mid.
383        - Changed LFO start levels: LFO1 and LFO2 both to mid, LFO3 to max. start
384          level (see discussion "GigaStudio LFO compatibility" on mailing list
385          from 2019-09-26 for details).
386        - Changed default wave form for all 3 LFOs to sine (instead of triangle;
387          see discussion "GigaStudio LFO compatibility" on mailing list from
388          2019-09-26 for details).
389        - Format extension: Added support for different LFO wave forms (currently
390          either sine [default], triangle, saw or square).
391        - Format extension: Added support for LFO phase displacement (0°..360°).
392        - Format extension: Added support for flipping LFO polarity on LFO 3
393          (in the original gig format this was only available for LFO 1 and LFO 2).
394        - Format extension: Support for additional filter types:
395          lowpass 1/2/4/6-pole, highpass 1/2/4/6-pole, bandpass 2-pole,
396          bandreject 2-pole.
397        - Fixd potential crash with polynomial interpolator and max. pitch.
398        - If minimum cutoff is defined, remap cutoff controller CC values to really
399          span the entire possible cutoff range (and avoiding a dead controller
400          zone).
401        - Implemented support for loading instrument scripts with 'patch' variables
402          (by patching these script variables with potentially overridden ones by
403          gig Instrument).
404    
405      * SFZ format engine:
406        - Fixed support for regions with loccN/hiccN conditions on more than one
407          MIDI controller.
408        - Fixed internal opcode 'xfin_hivel' falsely being set by user opcode
409          'xfin_lovel' (patch by Christian Czezatke).
410    
411      * Benchmarks:
412        - Fixed benchmarks/triang.cpp falsely having favoured "int math abs"
413          algorithm (since result of 2nd run was not accumulated).
414        - Added benchmark for saw wave (benchmarks/saw.cpp).
415        - Added benchmark for sine wave (benchmarks/sine.cpp).
416        - Added benchmark for square wave (benchmarks/square.cpp).
417        - Increased amount of benchmarks runs by factor 6 to achieve benchmark times
418          which are large enough on modern systems.
419    
420    Version 2.1.1 (27 Jul 2019)
421    
422      * Real-time instrument scripts:
423        - Fixed behavior of built-in NKSP functions change_sustain(),
424          change_cutoff_attack(), change_cutoff_decay(), change_cutoff_sustain()
425          and change_cutoff_release().
426    
427      * general changes:
428        - Only play release trigger samples on sustain pedal up if this behaviour
429          was explicitly requested by the instrument (otherwise only on note-off).
430        - Fixed compiler warnings.
431        - Fixed compilation error when cross-compiling to Mac.
432        - FX Sends: Provide more useful error messages on routing problems
433          (see bug #169).
434        - LSCP doc: Be more clear describing the two distinct approaches
435          of using external vs. internal effects (see bug #169).
436        - "optional" class: Fixed comparison operators.
437    
438      * Gigasampler/GigaStudio format engine:
439        - Format extension: If requested by instrument then don't play release
440          trigger sample on note-off events.
441    
442      * SFZ format engine:
443        - Fixed memory leak when releasing samples
444          (fixes bug #307, patch by Jacek Roszkowski)
445        - Fixed potential crash when a sample is shared by more than one region
446          (fixes bug #308, patch by Jacek Roszkowski).
447        - Opcode 'sample': Added support for built-in sample '*silence'
448          (fixes bug #310, patch by Jacek Roszkowski).
449    
450    Version 2.1.0 (25 Nov 2017)
451    
452      * SFZ format engine:
453        - added support for <global>, <master> and #define (patch by Alby M)
454        - Removed code duplication in SFZ file loading code.
455        - Added support for sfz extension opcode 'script' which may be used to
456          load real-time instrument script file (NKSP script language).
457        - Implemented opcode set_ccN (initial patch by Giovanni Senatore).
458        - Fixed unintended volume fade-in of voices under certain conditions.
459        - sfz parser: allow missing space between header and opcode
460    
461      * Gigasampler/GigaStudio format engine:
462        - Fixed clicks and pumping noise with Lowpass Turbo filter on very low
463          cutoff settings.
464        - Got rid of resembling an ancient GSt misbehavior which did not pitch at
465          all if an up-pitch of more than 40 semi tones was requested (I don't
466          think there is any stock gig sound that requires this behavior to
467          resemble its original sound).
468        - Added support for controlling whether the individual EGADSR stages may
469          be aborted (as LinuxSampler extension to the original GigaStudio 4
470          format).
471    
472      * general changes:
473        - fixed printf type errors (mostly in debug messages)
474        - use unique_ptr instead of auto_ptr when building with C++11
475        - Added RTAVLTree class which is a real-time safe ordered multi-map, thus
476          allowing to sort data efficiently in real-time safe manner.
477        - RTList class: added methods for moving/inserting elements to arbitrary
478          position within a list.
479        - RTList class: added method fromPtr() for creating an Iterator object from
480          a raw element pointer.
481        - Attempt to partly fix resetting engine channels vs. resetting engine, an
482          overall cleanup of the Reset*(), ConnectAudioDevice(),
483          DisconnectAudioDevice() API methods would still be desirable though,
484          because the current situation is still inconsistent and error prone.
485        - Active voices are now internally grouped to "Note" objects, instead of
486          being directly assigned to a keyboard key. This allows more fine graded
487          processing of voices, which is i.e. required for certain instrument
488          script features.
489        - Fix: Release trigger voices were not spawned on sustain pedal up
490          (CC #64) events.
491        - Fix: Release trigger voices can now also distinguish correctly between
492          note-off and sustain pedal up events.
493        - All engines: Increased ramp speed of volume smoother and pan smoother
494          (while slow rate of crossfade smoother is preserved) to allow quick
495          volume and pan changes by instrument scripts for instance.
496        - gig/sf2/sfz: Fixed aftertouch channel pressure events being processed
497          properly and thus were ignored for certain uses.
498        - Added new C++ API method
499          VirtualMidiDevice::SendChannelPressureToSampler().
500        - windows, 32-bit: fixed potential crashes by making sure the stack in
501          sub threads is 16-byte aligned
502        - fixed numerous compiler warnings
503        - Fixed invalid (note-on) event ID being assigned to new Note objects.
504        - Revised fundamental C++ classes "Thread", "Mutex" and "Condition" which
505          fixes potential undefined behavior.
506        - Fixed Note object leak when triggering notes on keys which did not
507          have a valid sample mapped (fixes bug #252).
508        - Fixed compilation errors when compiling with CONFIG_DEVMODE enabled.
509        - linuxsampler binary fix: option --create-instruments-db ignored
510          subsequent optional argument due to glibc's implementation oddity
511          which expects a "=" sign, but no space between them.
512    
513      * packaging changes:
514        - removed unnecessary dependency to libuuid
515          (originated by libgig's usage of it)
516        - Automake: set environment variable GCC_COLORS=auto to allow GCC to
517          auto detect whether it (sh/c)ould output its messages in color.
518        - Debian: Fixed packaging error about invalid "Source-Version"
519          substitution variable.
520        - Debian: Raised Debian compatibility level to Debian 9 "Stretch".
521        - Debian: Added build dependency to libsqlite3-dev for building
522          linuxsampler with instruments DB support.
523    
524      * Real-time instrument scripts:
525        - Implemented scheduler for delayed MIDI events and for suspended scripts.
526        - Built-in script function "wait()": implemented support for function's
527          "duration-us" argument, thus scripts using this function are now
528          correctly resumed after the requested amount of microseconds.
529        - Built-in script function "play_note()": implemented support for
530          function's "duration-us" argument, thus notes triggered with this
531          argument are now correctly released after the requested amount of
532          microseconds.
533        - Fix: script events were not cleared when engine channel was reset,
534          potentially causing undefined behavior.
535        - Fixed crash which happened when trying to reference an undeclared
536          variable.
537        - Built-in script function "play_note()": Added support for passing
538          special value -1 for "duration-us" argument, which will cause the
539          triggered note to be released once the original note was released.
540        - Instrument script classes now exported with the liblinuxsampler C++ API.
541        - Added new API method ScriptVM::syntaxHighlighting() which provides
542          a convenient syntax highlighting backend for external instrument
543          script editor applications.
544        - Added new C++ API class "ScriptVMFactory".
545        - Extended parser issues to provide not only first line and first
546          column, but also last line and last column of issue (thus marking
547          the precise span of the issue within the source code).
548        - Reload script automatically after being modified by an instrument
549          editor.
550        - NKSP language grammar correction: allow empty event handler bodies
551          like "on note end on".
552        - Implemented built-in script function "change_vol()".
553        - Implemented built-in script function "change_tune()".
554        - Implemented built-in script function "change_pan()".
555        - Implemented built-in script function "change_cutoff()".
556        - Implemented built-in script function "change_reso()".
557        - Implemented built-in script function "event_status()".
558        - Added built-in script constants "$EVENT_STATUS_INACTIVE" and
559          "$EVENT_STATUS_NOTE_QUEUE" both for being used as flags for
560          "event_status()" function.
561        - NKSP language: Added support for bitwise operators ".or.", ".and."
562          and ".not.".
563        - NKSP language scanner: Fixed IDs matching to require at least one
564          character (i.e. when matching function names or variable names).
565        - NKSP language scanner: disabled unusued rules.
566        - Fixed behavior of play_note() and note_off() functions which must
567          be distinguished engine internally from "real" MIDI note on/off
568          events in order to avoid misbehaviors like hanging notes.
569        - Implemented built-in script variable "$KSP_TIMER".
570        - Implemented built-in script variable "$NKSP_REAL_TIMER".
571        - Implemented built-in script variable "$NKSP_PERF_TIMER".
572        - Implemented built-in script variable "$ENGINE_UPTIME".
573        - Implemented built-in script function "inc()".
574        - Implemented built-in script function "dec()".
575        - NKSP language fix: division expressions were evaluated too often.
576        - NKSP language fix: string concatenation operator was right
577          associative instead of left (to right).
578        - NKSP language correction: allow empty statements in entire language
579          (i.e. "if end if").
580        - Implemented built-in script function "stop_wait()".
581        - Implemented built-in script variable "$NI_CALLBACK_ID".
582        - Implemented built-in script variable "$NI_CALLBACK_TYPE".
583        - Implemented built-in script variable "$NKSP_IGNORE_WAIT".
584        - Added support for read-only built-in variables (respectively
585          handled by the script parser).
586        - Added built-in script constant "$NI_CB_TYPE_INIT".
587        - Added built-in script constant "$NI_CB_TYPE_NOTE".
588        - Added built-in script constant "$NI_CB_TYPE_RELEASE".
589        - Added built-in script constant "$NI_CB_TYPE_CONTROLLER".
590        - NKSP Language: Added support for user defined script functions.
591        - Implemented built-in script function "change_attack()".
592        - Implemented built-in script function "change_decay()".
593        - Implemented built-in script function "change_release()".
594        - Fixed all change_*() built-in script functions to apply their
595          synthesis parameter changes immediately in case the respective note
596          was triggered at the same time, instead of scheduling the parameter
597          change, especially because it would cause some parameter types's
598          changes either to be ramped (i.e. change_vol()) or other types even
599          to have not effect at all (i.e. change_attack()).
600        - Implemented built-in script function "sh_left()".
601        - Implemented built-in script function "sh_right()".
602        - Implemented built-in script function "min()".
603        - Implemented built-in script function "max()".
604        - NKSP Fix: "init" event handler was not always executed when a script
605          was loaded.
606        - NKSP built-in wait() script function: abort script execution if
607          a negative or zero wait time was passed as argument (since this is
608          a common indication of a bug either of the script or even of the
609          engine, which could lead to RT instability or even worse).
610        - ScriptVM: Implemented automatic suspension of RT safety
611          threatening scripts.
612        - Provide more user friendly error messages on syntax errors.
613        - Fixed NKSP parser warning "Not a statement" when assigning an
614          initializer list to an array variable.
615        - Implemented built-in script array variable "%ALL_EVENTS".
616        - Implemented built-in script function "in_range()".
617        - Implemented built-in script function "change_amp_lfo_depth()".
618        - Implemented built-in script function "change_amp_lfo_freq()".
619        - Implemented built-in script function "change_pitch_lfo_depth()".
620        - Implemented built-in script function "change_pitch_lfo_freq()".
621        - Implemented built-in script function "change_vol_time()".
622        - Implemented built-in script function "change_tune_time()".
623        - Implemented built-in script function "fade_in()".
624        - Implemented built-in script function "fade_out()".
625        - Fixed acceptance of wrong data type of parameters passed to built-in
626          script functions "change_vol()", "change_tune()", "change_pan()",
627          "change_cutoff()", "change_reso()", "change_attack()", "change_decay()",
628          "change_release()", "change_amp_lfo_depth()", "change_amp_lfo_freq()",
629          "change_pitch_lfo_depth()" and "change_pitch_lfo_freq()".
630        - Added built-in script function "get_event_par()" and implemented some
631          of its possible parameter selections.
632        - Added built-in script function "set_event_par()" and implemented some
633          of its possible parameter selections.
634        - Fixed a bunch of scheduler time related bugs.
635        - Fixed polyphonic variables not being reset to zero after usage.
636        - Built-in "ignore_event()" function: argument is now optional, like with
637          built-in function "ignore_controller()".
638        - Implemented built-in script function "change_velo()".
639        - Implemented built-in script function "change_note()".
640        - Adjusted behavior of "change_vol()" and "change_tune()" to a more
641          intuitive behavior if used in combination with "change_vol_time()" or
642          "change_tune_time()" respectively: now tuning/volume changes are only
643          assigned (without delay) immediately to a new note if the respective
644          timing function has not been called before, otherwise the volume/tuning
645          changes are automatically faded (before, only the event's time stamp was
646          relevant).
647         - Implemented built-in script function "array_equal()".
648         - Implemented built-in script function "search()".
649         - Implemented built-in script function "sort()".
650         - NKSP Fix: Never suspend "init" event handlers.
651         - Implemented built-in script function "same_region()" (currently only
652           available for gig format engine).
653         - Added built-in script constant "$NKSP_LINEAR".
654         - Added built-in script constant "$NKSP_EASE_IN_EASE_OUT".
655         - Implemented built-in script function "change_vol_curve()".
656         - Implemented built-in script function "change_tune_curve()".
657         - built-in "play_note()" function now supports a sample playback start
658           offset with argument 3, where special value -1 means to use the regular
659           sample offset as defined by the instrument file.
660         - Built-in array variable %KEY_DOWN[] is now a read-only variable.
661         - Built-in variable $EVENT_NOTE is now a read-only variable.
662         - Built-in variable $EVENT_VELOCITY is now a read-only variable.
663         - built-in "play_note()" function now accepts -2 for its fourth argument
664           (note duration) which means the life time of the note shall be sticked
665           to the requested note number of argument 1.
666         - Fix: built-in "play_note()" function now returns 0 as result value if
667           -1 was passed for its fourth argument (note duration) and the respective
668           parent note is already gone.
669        - Implemented built-in script function "change_play_pos()".
670        - NKSP language: Added support for user declared const array variables.
671        - NKSP language: Raise parser warning if array variable is accessed with
672          an index that exceeds the array's size.
673        - NKSP language fix: Unknown characters were not handled correctly.
674        - NKSP language: Added support for "synchronized .. end synchronized"
675          code blocks.
676        - Implemented built-in script function "abort()" which allows to abort
677          another script handler by passing its callback ID.
678        - Fixed potential memory access bug and potential undefined behavior of
679          "init" event handlers.
680        - Print a time stamp along to each call of built-in function "message()".
681        - ScriptVM API: Added VMParserContext::preprocessorComments() which allows
682          to retrieve all code blocks filtered out by the preprocessor.
683        - Added built-in script function "fork()".
684        - Added built-in array variable %NKSP_CALLBACK_CHILD_ID[].
685        - Added built-in variable $NKSP_CALLBACK_PARENT_ID.
686        - Fixed potential crash when accessing dynamic built-in array variables.
687        - Added built-in script function "callback_status()".
688        - Added built-in constant $CALLBACK_STATUS_TERMINATED.
689        - Added built-in constant $CALLBACK_STATUS_QUEUE.
690        - Added built-in constant $CALLBACK_STATUS_RUNNING.
691        - Removed max. value limitation of built-in functions "change_attack()",
692          "change_decay()" and "change_release()" to i.e. allow passing 2000000
693          for doubling the respective time.
694        - NKSP script editor syntax highlighting API: Fixed app termination due
695          to a lexer start condition stack underrun.
696        - NKSP preprocessor: Fixed wrong behavior on nested USE_CODE_IF() and
697          USE_CODE_IF_NOT() preprocessor statements.
698        - NKSP: Added built-in preprocessor condition NKSP_NO_MESSAGE, which
699          can be set to disable all subsequent built-in "message()" function calls
700          on preprocessor level.
701        - Implemented built-in script function "change_sustain()".
702        - NKSP script editor syntax highlighting API: catch all fatal lexer errors,
703          to avoid the editor app to crash on ill-formed text input.
704        - Added built-in script function "change_pan_time()".
705        - Added built-in script function "change_pan_curve()".
706        - Added built-in script function "change_cutoff_attack()".
707        - Added built-in script function "change_cutoff_decay()".
708        - Added built-in script function "change_cutoff_sustain()".
709        - Added built-in script function "change_cutoff_release()".
710        - Added built-in script function "change_cutoff_lfo_depth()".
711        - Added built-in script function "change_cutoff_lfo_freq()".
712    
713      * Instruments DB:
714        - Fixed memory access bug of general DB access code which lead to
715          undefined behavior.
716        - Cleanup of instruments DB file creation and opening code.
717        - The instrument DB path of linuxsampler's --create-instruments-db argument
718          is now optional, if it is missing, then a default location is used.
719        - Added support for scanning SFZ (.sfz) files.
720        - Added support for scanning Sound Font (.sf2) files.
721        - Fixed undefined DB transaction behavior.
722    
723    Version 2.0.0 (15 July 2015)
724    
725    * packaging changes:    * packaging changes:
726        - fixed building with newer MinGW-w64
727        - Mac OS X: support the new dir for Core Audio SDK
728        - Mac OS X: fixed building outside source directory
729        - made sure all source files for hostplugins are included when
730          doing "make dist"
731        - removed empty directories left from the cvs to svn migration
732        - fixed compilation with gcc 4.6.1
733        - another "make dist" fix, for the LV2 plugin
734        - made --enable-pthread-testcancel default on Mac OS X
735        - minor Makefile fix for building lscpparser when build and source
736          directories are separate
737        - Mac OS X: made it possible to specify plugin installation dir to
738          configure
739        - Mac OS X: Makefile fix for the install-strip target
740        - fixed compilation with gcc 4.7
741        - fixed configure script error with old autoconf versions
742        - lsatomic.h: use gcc provided atomic functions if building with
743          gcc 4.7 and C++11
744        - modernized configure script
745        - fixed linkage error when building with
746          LDFLAGS="-Wl,--no-undefined" (#190)
747        - fixed compilation with Clang 3.2
748        - removed usage of deprecated Automake variable INCLUDES
749        - fixed building with C++11
750        - build fix: ChangeFlagRelaxed.h was missing in makefile
751        - build fix: libsndfile compiler flags were missing in some
752          makefiles
753        - fix for building with bison 3.0 (#202)
754        - Mac OS X: added temporary hack allowing to spawn gigedit as callback
755          on the process's main thread
756        - fixed build error on newer MinGW
757        - support building with older jack versions
758        - support building with spaces in vst sdk path
759        - enabled automake 'subdir-objects' option and moved external
760          source references (vst, au, asio) from makefiles to cpp files,
761          in order to get rid of warnings from automake 1.14
762    
763      * general changes:
764        - Refactoring: moved the independent code from
765          the Gigasampler format engine to base classes
766        - command line option '--profile' is currently disabled, since the
767          respective profiling code is currently broken
768        - Introduced support for optional environment variable
769          "LINUXSAMPLER_PLUGIN_DIR" which allows to override the directory
770          where the sampler shall look for instrument editor plugins
771          (patch by Luis Garrido, slightly modified).
772        - implemented Roland GS NRPN 1ArrH which allows to set volume per note
773        - implemented Roland GS NRPN 1CrrH which allows to set pan per note
774        - implemented Roland GS NRPN 1DrrH which allows to set reverb send per
775          note (in this implementation of the sampler its simply hard routed to
776          the 1st effect send of the sampler channel, no matter what the actual
777          effect type is)
778        - implemented Roland GS NRPN 1ErrH which allows to set chorus send per
779          note (in this implementation of the sampler its simply hard routed to
780          the 2nd effect send of the sampler channel, no matter what the actual
781          effect type is)
782        - implemented support for internal LADSPA effects
783        - raised limit of program change queue from 100 to 512
784          (as suggested by Alex Stone)
785        - implemented sine LFO, pulse LFO and saw LFO
786        - experimental support for per voice equalization
787        - added command line option --exec-after-init
788        - Introduced new C++ API method:
789          EngineChannel::InstrumentFileName(int index)
790          allowing to retrieve the whole list of files used for the loaded
791          instrument on an engine channel (a.k.a. part). Some GigaStudio
792          instruments for example are splitted over several files like
793          "Foo.gig", "Foo.gx01", "Foo.gx02", ...
794        - Added new C++ API method Sampler::GetGlobalMaxVoices().
795        - Added new C++ API method Sampler::GetGlobalMaxStreams().
796        - Added new C++ API method Sampler::SetGlobalMaxVoices().
797        - Added new C++ API method Sampler::SetGlobalMaxStreams().
798        - Various "const" and "restrict" optimizations.
799        - all engines: add pan CC value to instrument pan parameter before
800          applying panning, instead of using two separate pan functions in
801          series (#182)
802        - added a lock guard class for exception safe mutex handling and
803          used it everywhere appropriate
804        - Immediately apply scale tuning changes to active voices.
805        - Exposed scale tuning to C++ API (along to the already existing standard
806          SysEx way).
807        - lsatomic.h fixes: seq_cst load and store were suboptimal for x86
808          and broken for ppc64. (Seq_cst loads and stores are actually not
809          used in LS, so the bug wasn't noticable.)
810        - lsatomic.h: added ARMv7 support
811        - Added support for multiple MIDI input ports per sampler channel (and
812          added various new C++ methods for this new feature / design change, old
813          C++ API methods for managing SamplerChannel's MIDI inputs are now marked
814          as deprecated but are still there and should provide full behavior
815          backward compatibility).
816        - AbstractEngine::GSChecksum(): don't allocate memory on the stack (was
817          unsafe and caused compilation error with clang 2.x).
818        - Bugfix: only process the latest MIDI program change event.
819        - Introducing the LSCP shell, which provides convenient control of the
820          sampler from the command line by providing LSCP aware features.
821        - VirtualMidiDevice: Added support for program change.
822        - VirtualMidiDevice: Added support for bank select (MSB & LSB).
823        - VirtualMidiDevice: Added support for pitch bend.
824        - Aftertouch: extended API to explicitly handle channel pressure and
825          polyphonic key pressure events (so far polyphonic pressure was not
826          supported at all, and channel pressure was rerouted as CC128 but not
827          used so far).
828        - Added initial support for real-time instrument scripts. The script VM
829          code is shared by all sampler engine implemementations, however only the
830          gig file format currently provides support for storing instrument scripts
831          (as LinuxSampler extension to the original GigaStudio 4 format).
832    
833      * Gigasampler format engine:
834        - implemented the "round robin keyboard" dimension
835        - fixed round robin and random dimensions for cases when number of
836          dimension zones is not a power of two
837        - made round robin use a counter for each region instead of each
838          key
839        - bugfix: pitch LFO controller "internal+aftertouch" was broken
840        - bugfix: filter keyboard tracking was broken
841        - filter performance fix (an unnecessary copy was made of the
842          filter parameters in each sub fragment)
843        - handle special case when pan parameter in gig file has max or
844          min value
845        - Exclusive Groups: don't ever stop voices of the same note,
846          doesn't sound naturally with a drumkit
847        - fixed EG1 modulation when attack or release is zero
848        - Fixed support for 'aftertouch' attenuation controller.
849        - Fixed crash that happened with velocity split sounds under certain
850          conditions (see also previous commit on libgig).
851        - fixed behaviour of filter LFO
852    
853      * SFZ format engine:
854        - Initial implementation (not usable yet)
855        - added support for v2 multiple stage envelope generators
856        - added a fine-tuned v1 envelope generator instead of using the
857          one from the gig engine
858        - fixed memory leak and memory handling errors
859        - added support for trigger=first, trigger=legato and sw_previous
860        - allow non-numerical key values ("C#4" for example)
861        - "key" opcode now sets pitch_keycenter too
862        - fixed error when unloading instrument with same sample used by
863          multiple regions
864        - added some opcode aliases, like loopmode for loop_mode, to be
865          more compatible
866        - added support for trigger=release and rt_decay
867        - added support for off_mode=normal
868        - added support for random, seq_position, seq_length and volume
869        - added v1 LFO opcodes to parser (no support in engine yet)
870        - added support for amp_veltrack and amp_velcurve_N
871        - fine-tuned the default velocity curve
872        - added support for transpose
873        - fixed crash when using sw_down/up
874        - improved logic for sw_lokey/hikey/up/down/last
875        - added more v1 aliases to parser
876        - reduced memory usage for sfz data
877        - RT-safeness: avoid malloc in audio thread
878        - fixed a bug that could cause voice stealing to fail
879        - optimized sample lookup
880        - improved support for exclusive groups (group, off_by and
881          off_mode)
882        - added support for controller triggered regions (on_locc/on_hicc)
883        - added support for loop_mode=one_shot
884        - fixed playback of 16 bit wav files on big endian CPUs
885        - added support for Ogg Vorbis sample files
886        - use loop markers from sample file if loop_start and loop_end are
887          not set in sfz file
888        - implemeted filters. Filter types: lowpass, bandpass, bandreject
889          and highpass. 1, 2, 4 and 6 pole filters. Opcodes: fil_type,
890          cutoff, resonance, fil_veltrack, fil_keytrack, fil_keycenter,
891          cutoff_cc, cutoff_chanaft.
892        - bugfix: zero ampeg_sustain didn't work
893        - added support for velocity effect on amplifier envelope time
894          (ampeg_vel2attack, ampeg_vel2decay, ampeg_vel2sustain and
895          ampeg_vel2release)
896        - added support for EG hold (ampeg_hold)
897        - added support for sample offset (offset)
898        - use the newly introduced signal units model
899        - implemented opcodes lfoN_delay,
900          lfoN_freq, lfoN_pan, lfoN_cutoff, lfoN_resonance
901        - implemented opcodes ampeg_delay, ampeg_vel2delay
902          pitcheg_delay, pitcheg_start, pitcheg_attack, pitcheg_hold,
903          pitcheg_decay, pitcheg_sustain, pitcheg_release, pitcheg_vel2delay,
904          pitcheg_vel2attack, pitcheg_vel2hold, pitcheg_vel2decay,
905          pitcheg_vel2sustain, pitcheg_vel2release, pitcheg_depth
906        - implemented opcodes pitchlfo_delay, pitchlfo_freq,
907          pitchlfo_depth, fillfo_delay, fillfo_freq, fillfo_depth,
908          amplfo_delay, amplfo_freq, amplfo_depth
909        - implemented opcodes fileg_delay, fileg_start, fileg_attack,
910          fileg_hold, fileg_decay, fileg_sustain, fileg_release, fileg_vel2delay,
911          fileg_vel2attack, fileg_vel2hold, fileg_vel2decay, fileg_vel2sustain,
912          fileg_vel2release
913        - implemented opcode lfoN_wave
914        - implemented opcode pitchlfo_depthccN
915        - implemented opcodes lfoN_phase, lfoN_phase_onccX,
916          lfoN_pitch, lfoN_pitch_onccX
917        - implemented opcodes pitchlfo_fade,
918          fillfo_fade, amplfo_fade, lfoN_fade, lfoN_fade_onccX
919        - implemented opcodes fillfo_freqccN,
920          pitchlfo_freqccN, amplfo_freqccN, lfoN_freq_onccX
921        - implemented opcodes ampeg_delayccN, ampeg_startccN,
922          ampeg_attackccN, ampeg_holdccN, ampeg_decayccN, ampeg_sustainccN,
923          ampeg_releaseccN, egN_timeX_onccY, egN_levelX_onccY
924        - lfoN_* and egN_* opcodes defined in group sections
925          are now taken into account
926        - implemented curves
927        - implemented opcodes volume_onccN, volume_curveccN
928        - implemented opcode volume_smoothccN
929        - implemented opcodes fillfo_depthccN, amplfo_depthccN,
930          lfoN_volume, lfoN_volume_onccX, lfoN_volume_smoothccX,
931          lfoN_freq_smoothccX, lfoN_pitch_smoothccX, lfoN_pan_onccX,
932          lfoN_pan_smoothccX, lfoN_cutoff_onccX, lfoN_cutoff_smoothccX,
933          lfoN_resonance_onccX, lfoN_resonance_smoothccX, lfoN_delay_onccX
934        - implemented opcode end
935        - implemented opcodes egN_amplitude_onccX,
936          egN_volume, egN_volume_onccX, egN_cutoff, egN_cutoff_onccX,
937          egN_pitch, egN_pitch_onccX, egN_resonance, egN_resonance_onccX
938        - implemented opcodes xfin_lokey, xfin_hikey,
939          xfout_lokey, xfout_hikey, xf_keycurve, xfin_lovel, xfin_hivel,
940          xfout_lovel, xfout_hivel, xf_velcurve, xfin_loccN, xfin_hiccN,
941          xfout_loccN, xfout_hiccN, xf_cccurve
942        - implemented opcodes pan_onccN, pan_smoothccN,
943          pan_curveccN, egN_pan, egN_pan_curve, egN_pan_onccX,
944          egN_pan_curveccX, pitch_veltrack
945        - when failed to parse a sfz file
946          print the line number on which the error occurs
947        - use common pool of CC objects to minimize RAM usage
948        - implemented opcodes amplfo_delay_onccN,
949          amplfo_fade_onccN, fillfo_delay_onccN, fillfo_fade_onccN,
950          pitchlfo_delay_onccN, pitchlfo_fade_onccN
951        - implemented opcodes fileg_delay_onccN,
952          fileg_start_onccN, fileg_attack_onccN, fileg_hold_onccN,
953          fileg_decay_onccN, fileg_sustain_onccN, fileg_release_onccN,
954          fileg_depth_onccN, pitcheg_delay_onccN, pitcheg_start_onccN,
955          pitcheg_attack_onccN, pitcheg_hold_onccN, pitcheg_decay_onccN,
956          pitcheg_sustain_onccN, pitcheg_release_onccN, pitcheg_depth_onccN
957        - implemented automatic aliasing *ccN <-> *_onccN
958        - *lfo_freqccN wasn't working when the respective *lfo_freq
959          was not set or was set to zero
960        - lfoN_freq_onccX wasn't working when lfoN_freq
961          was not set or was set to zero
962        - implemented opcodes resonance_onccN, resonance_smoothccN,
963          resonance_curveccN, cutoff_smoothccN, cutoff_curveccN
964        - implemented opcodes fillfo_depthchanaft,
965          fillfo_freqchanaft, amplfo_depthchanaft, amplfo_freqchanaft,
966          pitchlfo_depthchanaft, pitchlfo_freqchanaft
967        - implemented opcodes pitch_onccN,
968          pitch_curveccN, pitch_smoothccN, pitch_stepccN
969        - implemented opcodes volume_stepccN, pan_stepccN,
970          cutoff_stepccN, resonance_stepccN, lfoN_freq_stepccX,
971          lfoN_volume_stepccX, lfoN_pitch_stepccX, lfoN_pan_stepccX,
972          lfoN_cutoff_stepccX, lfoN_resonance_stepccX
973        - implemented opcodes eq1_freq, eq2_freq, eq3_freq,
974          eq1_freqccN, eq2_freqccN, eq3_freqccN, eq1_bw, eq2_bw, eq3_bw,
975          eq1_bwccN, eq2_bwccN, eq3_bwccN, eq1_gain, eq2_gain, eq3_gain,
976          eq1_gainccN, eq2_gainccN, eq3_gainccN
977        - implemented opcodes delay, delay_onccN, delay_random,
978          delay_samples, delay_samples_onccN
979        - implemented opcodes egN_eq1gain, egN_eq2gain, egN_eq3gain,
980          egN_eq1gain_onccX, egN_eq2gain_onccX, egN_eq3gain_onccX, egN_eq1freq,
981          egN_eq2freq, egN_eq3freq, egN_eq1freq_onccX, egN_eq2freq_onccX,
982          egN_eq3freq_onccX, egN_eq1bw, egN_eq2bw, egN_eq3bw, egN_eq1bw_onccX,
983          egN_eq2bw_onccX, egN_eq3bw_onccX, lfoN_eq1gain, lfoN_eq2gain,
984          lfoN_eq3gain, lfoN_eq1gain_onccX, lfoN_eq2gain_onccX, lfoN_eq3gain_onccX,
985          lfoN_eq1gain_smoothccX, lfoN_eq2gain_smoothccX, lfoN_eq3gain_smoothccX,
986          lfoN_eq1gain_stepccX, lfoN_eq2gain_stepccX, lfoN_eq3gain_stepccX,
987          lfoN_eq1freq, lfoN_eq2freq, lfoN_eq3freq, lfoN_eq1freq_onccX,
988          lfoN_eq2freq_onccX, lfoN_eq3freq_onccX, lfoN_eq1freq_smoothccX,
989          lfoN_eq2freq_smoothccX, lfoN_eq3freq_smoothccX, lfoN_eq1freq_stepccX,
990          lfoN_eq2freq_stepccX, lfoN_eq3freq_stepccX, lfoN_eq1bw, lfoN_eq2bw,
991          lfoN_eq3bw, lfoN_eq1bw_onccX, lfoN_eq2bw_onccX, lfoN_eq3bw_onccX,
992          lfoN_eq1bw_smoothccX, lfoN_eq2bw_smoothccX, lfoN_eq3bw_smoothccX,
993          lfoN_eq1bw_stepccX, lfoN_eq2bw_stepccX, lfoN_eq3bw_stepccX
994        - implemented opcodes eq1_vel2freq, eq2_vel2freq,
995          eq3_vel2freq, eq1_vel2gain, eq2_vel2gain, eq3_vel2gain
996        - sfz parser: allow double spaces in sample filenames
997        - sfz parser: allow absolute paths for sample filenames
998        - use linear decay and release for filter and pitch EG
999        - bugfix: only the first amp_veltrack definition in a file was
1000          used
1001        - bugfix: looping was disabled if loop_start was set to 0
1002        - allow regions with end=-1 to turn off other regions using the
1003          group and off_by opcodes (#168)
1004        - made end=0 play the whole sample
1005        - fixed support for lochan and hichan opcodes (#155)
1006        - fixed crash when using lochan/hichan opcodes (#187)
1007        - sfz parser: allow -200 to 200 for pan_oncc opcode (#182)
1008        - added FLAC support (#191)
1009        - sfz parser bugfix: lines starting with whitespace were ignored
1010        - added amplitude opcode
1011        - added support for "#include" instruction
1012          (modified patch which was originally posted by Sergey on LS mailing list)
1013        - bugfix: generation of velocity curves etc should not be done
1014          after each "#include", only after the main file is parsed
1015        - bugfix: line numbers in error messages were wrong after "#include"
1016        - added support for float and 32 bit sample files
1017    
1018      * SoundFont format engine:
1019        - Initial implementation (not usable yet)
1020        - RT-safeness: avoid malloc in audio thread
1021        - fixed a bug that could cause voice stealing to fail
1022        - fine-tuned amplitude EG (by switching from gig to sfz EG)
1023        - initial implementation of Vibrato LFO and Modulation LFO
1024        - initial implementation of cutoff filter
1025        - use linear decay and release for filter and pitch EG
1026    
1027      * Host plugins (VST, AU, LV2, DSSI):
1028        - AU bugfix: failed to destroy its audio/MIDI devices
1029        - Listen to all interfaces on Mac OS X (INADDR_ANY)
1030        - VST bugfix: If the host called resume() before and after
1031          changing sample rate or block size, the number of channels was
1032          incorrectly set to two. This caused silence in Cubase 5.
1033        - save engine type (gig, sfz or sf2) in plugin state
1034        - VST: when opening Fantasia, look for both 32 and 64 bit Java on
1035          64 bit Windows
1036        - AU: changed number of output channels from one stereo to 16
1037          stereo
1038        - VST: made it possible to build the VST plugin for Mac
1039        - AU: link AU plugin dynamically if --disable-shared isn't
1040          specified
1041        - LV2 "state" extension support (patch by David Robillard)
1042        - VST bugfix: instrument loading hang and crashed the host when
1043          the plugin was loaded a second time (#174)
1044        - plugin bugfix: instrument loading hang when the plugin was
1045          loaded a second time (this time it's for Linux and Mac, previous
1046          similar fix was for Windows)
1047        - thread safety fixes for the instrument loading thread
1048        - LV2: use the new lv2 package if present
1049        - VST: try to open Fantasia automatically on Linux and Mac too (on
1050          Linux, the Fantasia jar should be placed in <prefix>/share/java)
1051        - VST: fixed crashes on Linux Ardour and EnergyXT
1052        - DSSI bugfix: it wasn't possible to change engine type. The MIDI
1053          port and audio channel routing for DSSI plugins are now visible.
1054        - LV2: use urid and atom extensions instead of deprecated uri-map
1055          and event
1056        - LV2: lv2 package 1.0 is now required to build the LV2 plugin
1057        - LV2: changed number of output channels to 16 stereo, just like
1058          the VST and AU plugins
1059        - LV2: fixed save/restore of SFZ state (patch by David Robillard)
1060        - LV2: made LV2 plugin buildable on Windows and Mac
1061        - VST: implemented retrieval and switching of programs using the
1062          sampler's internal MIDI instrument mapping system
1063    
1064      * Instrument editor interface:
1065        - Changed instrument editor plugin interface, providing additional
1066          informations like the EngineChannel for which the instrument editor was
1067          spawned for. This allows the instrument editors to interact more actively
1068          with the sampler.
1069    
1070      * MIDI driver:
1071        - ALSA MIDI driver supports now "NAME" device parameter, for overriding
1072          the ALSA sequencer client name
1073        - removed limit of maximum amount of MIDI ports per MIDI device, since
1074          there is no reason for this limit
1075        - MME: fixed memory handling bug found with cppcheck
1076        - MME: removed compiler warning
1077        - CoreMIDI: implemented driver specific port parameter "CORE_MIDI_BINDINGS",
1078          which allows to retrieve the list of CoreMIDI clients / ports and to connect
1079          to them a la JACK, via the usual sampler APIs
1080        - CoreMIDI: added driver specific port parameter "AUTO_BIND", if enabled
1081          the driver will automatically connect to other CoreMIDI clients' ports
1082          (e.g. external MIDI devices being attached to the Mac)
1083        - added support for MIDI note on velocity filter
1084        - CoreMIDI: fixed memory deallocation error
1085        - Fixed variable underflow in VirtualMidiDevice, which caused graphical
1086          virtual keyboards in frontends / instrument editors being stuck.
1087        - Bugfix in VirtualMidiDevice: process note on with velocity 0 as note off.
1088        - Implemented missing handling of MIDI "running status".
1089        - CoreMIDI fix: a MIDIPacket can contain more than one event per packet.
1090        - MME bugfix: driver wasn't closed properly
1091        - CoreMIDI: automatically connect to all input sources by default (driver
1092          parameter "AUTO_BIND").
1093        - CoreMIDI: fixed auto bind feature to CoreMIDI ports that go online
1094        - CoreMIDI: fixed minor memory leak
1095    
1096      * audio driver:
1097        - ASIO driver fixes for newer gcc versions (fix from PortAudio)
1098        - JACK audio: react on sample rate changes.
1099        - JACK audio: react on buffer size changes.
1100        - JACK audio: jack_port_get_buffer() was cached and called outside
1101          RT context.
1102        - ASIO driver: removed compiler warnings
1103        - CoreAudio: fixed minor error handling bug
1104        - ASIO driver: be more verbose when no ASIO card could be found (fixes #203)
1105        - JACK audio: return the JACK server's current sample rate as default value
1106          for audio device parameter "SAMPLERATE" (fixes #166).
1107    
1108      * LSCP server:
1109        - added support for sending MIDI CC messages via LSCP command
1110          "SEND CHANNEL MIDI_DATA CC <sampler-chan> <ctrl> <val>"
1111        - added LSCP command "GET AVAILABLE_EFFECTS"
1112        - added LSCP command "LIST AVAILABLE_EFFECTS"
1113        - added LSCP command "GET EFFECT INFO <effect-index>"
1114        - added LSCP command "CREATE EFFECT_INSTANCE <effect-index>"
1115        - added LSCP command
1116          "CREATE EFFECT_INSTANCE <effect-system> <module> <effect-name>"
1117        - added LSCP command "DESTROY EFFECT_INSTANCE <effect-instance>"
1118        - added LSCP command "GET EFFECT_INSTANCES"
1119        - added LSCP command "LIST EFFECT_INSTANCES"
1120        - added LSCP command "GET EFFECT_INSTANCE INFO <effect-instance>"
1121        - added LSCP command
1122          "GET EFFECT_INSTANCE_INPUT_CONTROL INFO <effect-instance> <input-control>"
1123        - added LSCP command "SET EFFECT_INSTANCE_INPUT_CONTROL VALUE
1124          <effect-instance> <input-control> <value>"
1125        - added LSCP command "GET SEND_EFFECT_CHAINS <audio-device>"
1126        - added LSCP command "LIST SEND_EFFECT_CHAINS <audio-device>"
1127        - added LSCP command "ADD SEND_EFFECT_CHAIN <audio-device>"
1128        - added LSCP command
1129          "REMOVE SEND_EFFECT_CHAIN <audio-device> <effect-chain>"
1130        - added LSCP command
1131          "GET SEND_EFFECT_CHAIN INFO <audio-device> <effect-chain>"
1132        - added LSCP command "APPEND SEND_EFFECT_CHAIN EFFECT <audio-device>
1133          <effect-chain> <effect-instance>"
1134        - added LSCP command "INSERT SEND_EFFECT_CHAIN EFFECT <audio-device>
1135          <effect-chain> <effect-chain-pos> <effect-instance>"
1136        - added LSCP command "REMOVE SEND_EFFECT_CHAIN EFFECT <audio-device>
1137          <effect-chain> <chain-pos>"
1138        - added LSCP command "SET FX_SEND EFFECT <sampler_channel>
1139          <fx_send_id> <effect_chain> <chain_pos>"
1140        - added LSCP command "REMOVE FX_SEND EFFECT <sampler_channel> <fx_send_id>"
1141        - added LSCP commands "SUBSCRIBE EFFECT_INSTANCE_COUNT",
1142          "SUBSCRIBE EFFECT_INSTANCE_INFO", "SUBSCRIBE SEND_EFFECT_CHAIN_COUNT",
1143          "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"
1144        - provide comprehensive error messages on LSCP syntax errors
1145          (suggesting expected next non-terminal symbols)
1146        - Fixed client connection not being closed after network errors.
1147    
1148      * LSCP shell:
1149        - Added support for auto correction of obvious and trivial syntax mistakes.
1150        - Added support for auto completion by tab key.
1151        - Show currently available auto completion while typing.
1152        - Added support for browsing command history with up / down keys.
1153        - Show all possible next symbols immediately right to the current command
1154          line while typing (no double tab required for this feature, as it would
1155          be the case in other shells).
1156        - Added support for moving cursor left/right with arrow keys.
1157        - Added support for built-in LSCP reference documentation, which will
1158          automatically show the relevant LSCP reference section on screen as soon
1159          as one specific LSCP command was detected while typing on the command
1160          line.
1161    
1162      * Real-time instrument scripts:
1163        - Implemented built-in script array variable %CC.
1164        - Implemented built-in script int variable $CC_NUM.
1165        - Implemented built-in script int variable $EVENT_NOTE.
1166        - Implemented built-in script int variable $EVENT_VELOCITY.
1167        - Implemented built-in script constant variable $VCC_MONO_AT.
1168        - Implemented built-in script constant variable $VCC_PITCH_BEND.
1169        - Implemented execution of script event handler "init".
1170        - Implemented execution of script event handler "controller".
1171        - Implemented execution of script event handler "note".
1172        - Implemented execution of script event handler "release".
1173        - Implemented built-in script function "play_note()" (only two of the
1174          max. four function arguments are currently implemented yet though).
1175        - Implemented built-in script int variable $EVENT_ID.
1176        - Implemented built-in script function "ignore_event()"
1177        - Implemented built-in script function "ignore_controller()" (may have one
1178          or no argument).
1179        - Implemented built-in script function "set_controller()".
1180        - Added extended script VM for the Gigasampler/GigaStudio format sampler
1181          engine, which extends the general instrument script VM with Giga format
1182          specific variables and functions.
1183        - Giga format scripts: added built-in script int constant variables
1184          $GIG_DIM_CHANNEL, $GIG_DIM_LAYER, $GIG_DIM_VELOCITY, $GIG_DIM_AFTERTOUCH,
1185          $GIG_DIM_RELEASE, $GIG_DIM_KEYBOARD, $GIG_DIM_ROUNDROBIN, $GIG_DIM_RANDOM,
1186          $GIG_DIM_SMARTMIDI, $GIG_DIM_ROUNDROBINKEY, $GIG_DIM_MODWHEEL,
1187          $GIG_DIM_BREATH, $GIG_DIM_FOOT, $GIG_DIM_PORTAMENTOTIME, $GIG_DIM_EFFECT1,
1188          $GIG_DIM_EFFECT2, $GIG_DIM_GENPURPOSE1, $GIG_DIM_GENPURPOSE2,
1189          $GIG_DIM_GENPURPOSE3, $GIG_DIM_GENPURPOSE4, $GIG_DIM_SUSTAIN,
1190          $GIG_DIM_PORTAMENTO, $GIG_DIM_SOSTENUTO, $GIG_DIM_SOFT,
1191          $GIG_DIM_GENPURPOSE5, $GIG_DIM_GENPURPOSE6, $GIG_DIM_GENPURPOSE7,
1192          $GIG_DIM_GENPURPOSE8, $GIG_DIM_EFFECT1DEPTH, $GIG_DIM_EFFECT2DEPTH,
1193          $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.
1194        - Giga format scripts: Implemented built-in script function
1195          "gig_set_dim_zone(event_id, dimension, zone)".
1196        - Implemented built-in script int array variable %KEY_DOWN.
1197        - Implemented built-in script function "abs()".
1198        - Implemented built-in script function "random()".
1199        - Implemented built-in script function "num_elements()".
1200        - Implemented built-in script function "note_off()".
1201        - Implemented built-in script function "set_event_mark()".
1202        - Implemented built-in script function "delete_event_mark()".
1203        - Implemented built-in script function "by_marks()".
1204        - Added built-in script int const variables $MARK_1 to $MARK_28.
1205        - Built-in script functions "ignore_event()", "note_off()" and
1206          "gig_set_dim_zone()" now also accept an array of event IDs as argument
1207          (i.e. return value of new script function "by_marks()").
1208        - Pass/preserve polyphonic variable data from respective "note" event
1209          handler to "release" event handler.
1210        - Fixed crash when using built-in script function "by_marks()".
1211    
1212      * Bug fixes:
1213        - Fixed crash which may occur when MIDI key + transpose is out of range
1214        - minor valgrind fixes
1215        - fixed crash which occurred when changing an already deployed sampler
1216          channel to a different engine type
1217        - fixed crash when deleting a sampler channel or changing engine
1218          type while an instrument load was in progress
1219        - bugfix: playing a note while changing the instrument could cause
1220          a crash, or give "Handing back unknown region" error messages
1221        - bugfix: calling SET VOICES (which Fantasia does on start and
1222          refresh) could cause instruments to be unloaded
1223        - Mac OS X: fixed name collision of enum in EffectControl and
1224          wrong name of destructor in AudioOutputDeviceCoreAudio.cpp
1225        - Mac OS X: fixed hanging threads
1226        - Windows: disabled the previous thread fix on non-Mac systems, as
1227          it caused hanging threads on Windows
1228        - Fixed possible crashes due to corrupted MIDI/audio device list
1229          after MIDI/audio device creation failure
1230        - When creating MIDI instrument map entries with "PERSISTENT" type, the
1231          instruments were uselessly precached with zero samples, however it still
1232          took the full preloading time and on 1st program change the respective
1233          instrument was completely reloaded again.
1234        - fixed handling of rapid bank select and program change messages
1235          sent to the same sampler channel (patch from the Open Octave
1236          project, slightly adjusted)
1237        - fixed crash when trying to create an effect instance with controls
1238          which min and/or max values depend on the sample rate
1239        - fixed bug #162
1240        - bugfix: LADSPA_PATH was not evaluated correctly when containing
1241          multiple paths (#165)
1242        - thread safety fixes for the instrument loading thread
1243        - bugfix: instrument loading crashed for sfz and sf2 in Ardour
1244          (#176)
1245        - more thread safety fixes for the instrument loading thread
1246        - sfz/sf2 engine: fixed crash when using small audio fragment size
1247        - Mac OS X: fixed crash when unloading plugin on 10.7 and later
1248        - Mac OS X: fixed process hang when unloading 32-bit plugin (bug
1249          introduced in previous fix)
1250        - fixed crash when a channel received a program change while
1251          playing a note in a key group
1252        - fixed erroneous error message piping in VoiceBase.h
1253          (labelled "Disk stream not available in time")
1254        - Update effects on sample rate & period size changes (to avoid
1255          crashes and noise on such transitions).
1256        - ignore missing LADSPA paths without ignoring valid LADSPA paths
1257          (fixes #208)
1258        - Fixed bug in LSCP grammar definition which caused a statement like
1259          "GET SERVER INFOasdf\n" to be accepted as valid statement (was so far
1260          practically irrelevant, however it caused problems with the new LSCP
1261          shell's auto completion feature).
1262        - Fixed MIDI program change messages being ignored if quickly executed
1263          after each other (fixes #231).
1264    
1265    Version 1.0.0 (31 July 2009)
1266    
1267      * packaging changes:
1268        - autoconf bugfix: the PKG_CONFIG variable wasn't initialized properly,
1269          causing e.g. the libgig test to fail when
1270          "./configure --disable-jack-driver" was used
1271          (patch by Alexis Ballier)
1272        - fixed compilation with gcc 4.3
1273        - fixes for building on OS X (thanks to Ebrahim Mayat for testing)
1274        - fixed configure so it detects x86_64 (#107)
1275        - fixes for building with newer MinGW versions
1276        - fix for building with bison 2.4 (#111)
1277        - fixed building with libgig installed in a non-standard directory
1278        - minor fix in configure for mmsystem.h detection on MinGW
1279        - Windows: look for editor plugins and Fantasia using base
1280          directory of liblinuxsampler dll (look in the same directory and one
1281          directory above)
1282        - configure script fix: removed unconditional use of SSE
1283        - fixed building with sqlite installed in a non-standard directory
1284        - when cross-compiling, don't try to create instruments.db
1285        - fix for new mingw-w64 version, which has usleep
1286    
1287      * general changes:
1288        - bugfix: on some POSIX systems instrument editor plugins refused to
1289          load as we used a non-portable Linux specific struct field
1290          (fixes bug #70, patch by Ronald Baljeu)
1291        - fixed endless loop which occured when loading an instrument editor
1292          plugin DLL on Windows systems failed
1293        - fixed memory leaks that occurred when liblinuxsampler was unloaded
1294        - optimized the SynchronizedConfig class so it doesn't wait
1295          unnecessarily long after an update
1296        - added support for notifying instrument editors on note-on / note-off
1297          events (e.g. to highlight the pressed keys on the virtual keyboard
1298          of gigedit)
1299        - added support for triggering notes by instrument editors (see above)
1300        - be verbose on DLL load errors (on Linux)
1301        - fixed di-harmonic triangle LFO implementation (this LFO implementation
1302          is only used by very few systems, most pick the int math
1303          implementation, which is usually faster)
1304        - fixes for audio drivers with varying buffer sizes
1305        - experimental support for running LinuxSampler as a DSSI, LV2 and
1306          VST plugin
1307        - notification events for stream/voice count statistics are now sent
1308          only when there are actual changes
1309        - added memory ordering constraints to improve stability on
1310          multi-core and multi-cpu systems
1311        - maximum voices and disk streams can now be altered at runtime
1312        - fixed CPU feature detection on x86_64 (maybe fixes #108)
1313        - automatic stacktrace mechanism is now turned off by default and can
1314          be switched on by command line option "--stacktrace" (the automatic
1315          stacktrace mechanism seems to be broken on most systems at the moment)
1316        - C++ API method InstrumentManager::LaunchInstrumentEditor() now returns
1317          a pointer to the launched InstrumentEditor object
1318        - added optional 3rd party user data parameter for following
1319          liblinuxsampler C++ API methods: InstrumentEditor::Main(),
1320          InstrumentEditor::Launch(),
1321          InstrumentManager::LaunchInstrumentEditor()
1322        - theoretical fix: made SynchronizedConfig follow C++0x memory
1323          model more strictly
1324        - fixes for using large audio device buffers
1325        - Windows: add the installation directory to the DLL search path
1326          when loading an editor plugin (solves problems with VST and
1327          gigedit on systems with other GTK versions installed)
1328        - updated linuxsampler man page
1329    
1330      * audio driver:
1331        - removed the nonsense audio channel constraint (which was hard coded to
1332          max. 100 audio channels) for most audio drivers
1333        - JACK audio driver did not offer a device parameter "SAMPLERATE" as
1334          opposed to the LSCP specs
1335        - bugfix: the SAMPLERATE parameter of some drivers (e.g. JACK)
1336          reflected the wrong value
1337        - fixed a memory management bug in ASIO driver
1338        - Makefile fix: JACK_CFLAGS wasn't used
1339        - JACK: use jack_client_open instead of the deprecated
1340          jack_client_new
1341        - added (experimental) CoreAudio driver
1342        - applied old fixes to the ASIO driver that were included in the
1343          previous binary release but accidentally never committed to CVS
1344          (fixes #117)
1345        - fixes for ASIO on mingw-w64 (iasio wrapper is not needed on
1346          win64)
1347        - VST: added support for sample rate and buffer size changes
1348        - VST: close editor (Fantasia) when the VST is removed
1349        - VST: avoid opening Fantasia more than once for each VST instance
1350        - VST: export main function as "main" on Linux too (fix for
1351          energyXT)
1352        - VST: changed number of output channels from one stereo to 16
1353          stereo
1354        - added channel routing, fxsends and midi maps to the settings
1355          stored in the plugin state
1356        - performance optimization of AudioChannel::MixTo() and
1357          AudioChannel::CopyTo() methods using GCC vector exensions
1358          (if available)
1359        - ASIO fixes: avoid initializing the device twice, avoid throwing
1360          exception when getting parameters from a disconnected device
1361    
1362      * MIDI driver:
1363        - added JACK MIDI driver
1364        - dispatch bank select as ordinary CC as well, the user might seriously
1365          want to (mis)use it for some purpose ("fixed" in all current MIDI
1366          input drivers: ALSA, CoreMIDI, JACK, MidiShare, MME)
1367        - bugfix: pitch bend wasn't working with JackMidi, VST, LV2, MME,
1368          CoreMidi or AU
1369        - fixed mingw-w64 compilation error in MME driver
1370        - made program change handling in MIDI thread real-time safe by
1371          moving the logic to a non-RT thread
1372        - fixed minor memory leak in ALSA driver
1373    
1374      * instruments database:
1375        - avoid time consuming samples scanning when adding instruments
1376          to the instruments database
1377        - added support for handling lost files in the instruments database
1378        - Implemented option for adding instruments in separate directories
1379          in the instruments database
1380          (patch by Chris Cherrett & Andrew Williams, a bit adjusted)
1381        - work-around for missing fnmatch function on Windows to make
1382          instrument database compilable
1383        - added instrument database support on Windows
1384          works with both standalone mode and VST plugin.
1385          the instruments DB file is located in
1386          %USERPROFILE%\.linuxsampler\instruments.db which allows different
1387          databases for each windows user
1388          if no DB is present it automatically creates the .linuxsampler subdir
1389          and then creates an empty DB
1390        - fixed recursive import, which was broken on Windows
1391    
1392      * Gigasampler format engine:
1393        - fixed a memory leak that could happen when a channel was deleted
1394          while notes were playing
1395        - made it possible to load an instrument even if the audio thread
1396          isn't running
1397        - added partial support for the "Controller Triggered" MIDI rule,
1398          enough for piano gigs with pedal noise samples
1399        - minor fix: only mark FX sends as being modified if really the
1400          respective FX send MIDI controller was used
1401        - added support for GM global device volume SysEx message
1402          (can be selected at compile time to either apply globally to the
1403          whole sampler [default] or only to the sampler channels that are
1404          connected to the respective MIDI input port the SysEx message arrived
1405          on)
1406        - bugfix: notes triggered at position 0 in the audio buffer were
1407          sometimes wrongly killed in the same buffer, causing no sound to
1408          be played
1409        - added support for chromatic / drumkit mode Roland GS Sysex message
1410          which is usally used to switch a part between chromatic sounds and
1411          drumkit sounds (as opposed to their common default setting of MIDI
1412          part 10 being a drumkit part and all other ones chromatic parts), in
1413          LS however one can switch between the first 16 MIDI instrument maps
1414          defined for the sampler
1415        - made it possible to create multiple sample channels even if the
1416          audio thread isn't running
1417        - fixed crash when removing channel with active voices (#116)
1418        - bugfix: on sample reference changes (instrument editor), only
1419          un-cache the respective sample if it's really not used by any
1420          sampler engine anymore
1421        - re-cache samples in case they were changed by an instrument editor,
1422          e.g. when a sample was added while playing (#82)
1423        - fixed hanging notes which occured when note-off event had the exact
1424          same time stamp as the voice's note-on event and occured both in the
1425          same audio fragment cycle (fixes bug #112)
1426        - added support for the "fine tune" and "pitch bend range"
1427          instrument-level gig parameters
1428        - fixed minor artifacts in pitch bend handling
1429        - added support for GS Reset SysEx message
1430        - allow gig files to use unlimited downward pitch shifting
1431        - added a limit check for upward pitch shifting
1432        - bugfix: sometimes, when playing a note twice fast, the second
1433          note was silent
1434        - fixed crash happening when a pitch bend event arrived at the
1435          same time a new instrument was loading
1436    
1437      * LSCP server:
1438        - added new LSCP event "CHANNEL_MIDI" which can be used by frontends to
1439          react on MIDI data arriving on certain sampler channels (so far only
1440          Note-On and Note-Off events are sent via this LSCP event)
1441        - added new LSCP event "DEVICE_MIDI" which can be used by frontends to
1442          react on MIDI data arriving on certain MIDI input devices (so far only
1443          Note-On and Note-Off events are sent via this LSCP event)
1444        - added new LSCP commands: FIND LOST DB_INSTRUMENT_FILES and
1445          SET DB_INSTRUMENT FILE_PATH
1446        - added new LSCP command: SEND CHANNEL MIDI_DATA which can be used by
1447          frontends to send MIDI messages to specific sampler channel
1448        - added two additional fields to GET FILE INSTRUMENT INFO command -
1449          KEY_BINDINGS and KEYSWITCH_BINDINGS
1450        - bugfix: the bank number provided by MIDI_INSTRUMENT_INFO notifications
1451          was incorrect
1452        - Optimized the retrieval of the MIDI instrument mappings
1453        - added new LSCP command "SET VOICES" to globally alter the maximum
1454          amount of voices, added new LSCP event "GLOBAL_INFO:VOICES" which will
1455          be triggered respectively
1456        - added new LSCP command "SET STREAMS" to globally alter the maximum
1457          amount of disk streams, added new LSCP event "GLOBAL_INFO:STREAMS"
1458          which will be triggered respectively
1459        - bugfix: retry if "select" returns EINTR (this fixes a crash when
1460          a gigedit file dialog is opened)
1461        - close all connections when LSCPServer is deleted
1462        - hard close of all sockets on exit
1463        - bugfix: SET CHANNEL MIDI_INPUT_TYPE didn't work with the MME
1464          driver
1465    
1466      * Bug fixes:
1467        - fixed a crash which occurs when removing a sampler channel waiting
1468          to start instrument loading after another channel
1469        - fixed a crash which occurs when removing a sampler channel with
1470          instrument loading in progress (bug #113)
1471        - fixed termination caused by uncaught exception when adding MIDI
1472          instrument with PERSISTENT load mode
1473        - fixed possible iterator invalidations when resetting the sampler
1474        - fixed memory leaks when issuing the following LSCP commands:
1475          GET AUDIO_OUTPUT_DRIVER INFO
1476          GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO
1477          GET MIDI_INPUT_DRIVER INFO
1478          GET MIDI_INPUT_DRIVER_PARAMETER INFO
1479        - fixed possible compilation error when sqlite is not present
1480        - fixed orphaned pointers when setting maximum voices limit (bug #118)
1481        - fixed crash when changing the audio output device of a sampler
1482          channel with loaded instrument and start playing notes
1483        - fixed endless loop in Engine::SuspendAll() (bug #120)
1484        - fixed a low-level atomic load function that was broken on 64-bit
1485          PowerPC, which probably could cause crashes on that platform
1486        - fixed a memory management error which could cause a crash when a
1487          plugin was unloaded
1488        - bugfix: two private structs had the same name, which could cause
1489          problems if the linker chose the wrong constructor
1490        - fixed low-level ConditionServer usage bug that caused lockups on
1491          Windows
1492    
1493    
1494    Version 0.5.1 (6 December 2007)
1495    
1496      * packaging changes:
1497        - added autoconf checks for pthread library
1498        - added autoconf check for pthread bug found on certain NPTL-enabled
1499          glibc versions (see Gentoo bug report #194076)
1500        - added autoconf checks for MS Windows
1501    
1502      * general changes:
1503        - bugfix: the thread used by an editor plugin didn't die when the
1504          editor closed
1505        - bugfix: Ringbuffer.h: fill_write_space_with_null() did not zero
1506          out all the space. operator--() did not apply size_mask after
1507          decrementing the read_ptr. DEFAULT_WRAP_ELEMENTS set to 0 in
1508          order to avoid problems with the _NonVolatileReader functions.
1509        - bugfix: Stream.h: added a missing divide by BytesPerSample in
1510          GetWriteSpace(). Since this function is currently only used in
1511          the stream's qsort() compare function, it didn't trigger any
1512          bugs.
1513        - Resampler.h, Synthesizer.h: cubic interpolation now works in
1514          24bit mode too. Faster method to read 24bit words on little
1515          endian machines (x86): replaced 3 byte reads + shifts with a 1
1516          unaligned 32bit read and shift
1517        - experimental support for MS Windows (MIDI input via MME, AUDIO
1518          output via ASIO)
1519        - made handling of SIGINT signal (Ctrl-C) a bit more robust
1520        - support for monitoring the total number of active disk streams
1521          (new LSCP commands: GET TOTAL_STREAM_COUNT,
1522          SUBSCRIBE TOTAL_STREAM_COUNT, UNSUBSCRIBE TOTAL_STREAM_COUNT)
1523    
1524      * AUDIO driver:
1525        - added Windows ASIO low latency audio driver
1526    
1527      * MIDI driver:
1528        - added MME Windows MIDI driver
1529    
1530      * LSCP server:
1531        - added support for Windows style path / filenames, however with
1532          forward slash path separators instead of backslash
1533          (i.e. "C:/foo/bar.gig")
1534        - allow naughty liblscp to send non-string device parameters within
1535          apostrophes as well
1536        - added new LSCP commands: "GET FILE INSTRUMENTS <file>",
1537          "LIST FILE INSTRUMENTS <file>" and
1538          "GET FILE INSTRUMENT INFO <file> <index>" for retrieving informations
1539          about an arbitrary instrument file on the system where the sampler is
1540          running on
1541    
1542    Version 0.5.0 (15 October 2007)
1543    
1544      * packaging changes:
1545        - config.h is not going to be installed along with liblinuxsampler's
1546          API header files anymore
1547      - only the API relevant header (and source) files will be exported to      - only the API relevant header (and source) files will be exported to
1548        the Doxygen API documentation (explicitly listed in Doxyfile.in)        the Doxygen API documentation (explicitly listed in Doxyfile.in)
1549        - added completely new XCode project files for Mac OSX which is now
1550          capable to execute our autoconf environment, thus no need anymore
1551          to maintain the compile time configuration file (osx/version.h) for
1552          OSX manually (patch by Toshi Nagata)
1553        - fixed buggy boolean --enable-foo / --disable-foo configure script
1554          parameters
1555        - global.h now only covers global definitions that are needed for the
1556          C++ API header files, all implementation internal global definitions
1557          are now in global_private.h
1558        - atomic.h is not exposed to the C++ API anymore
1559        - no need to include config.h anymore for using LS's API header files
1560        - fixed warnings in API doc generation
1561    
1562    * general changes:    * general changes:
1563      - replaced the old, confusing MIDI program change mechanism by a      - replaced the old, confusing MIDI program change mechanism by a
# Line 32  Version CVS HEAD (?) Line 1587  Version CVS HEAD (?)
1587        controllers        controllers
1588      - global (sampler wide) volume can now be controlled at runtime      - global (sampler wide) volume can now be controlled at runtime
1589      - Implemented new, improved notification system      - Implemented new, improved notification system
1590        - fixed compilation errors regarding OSX
1591          (patch by Toshi Nagata)
1592        - implemented instruments database
1593        - added support for escape sequences to the instruments database
1594        - added highly experimental support for on-the-fly instrument editing
1595          within the sampler's process (by using instrument editor plugins),
1596          you'll notice the new "Registered instrument editors:" message on
1597          startup, added a new LSCP command:
1598          "EDIT CHANNEL INSTRUMENT <sampler-channel>"
1599          to spawn a matching instrument editor for the instrument on the
1600          given sampler channel, the plugin path can be overridden at compile
1601          time with ./configure --enable-plugin-dir=/some/dir
1602        - added experimental code for synchronizing instrument editors hosted
1603          in the sampler's process to safely edit instruments while playing
1604          without a crash (hopefully) by either suspending single regions
1605          wherever possible or if unavoidable whole engine(s)
1606        - fixed several issues in fundamental "Thread" class: set scheduling
1607          policy and priority on thread level, set a minimum stack size for
1608          thread (TODO: a reasonable value yet to be tested), bugfix: non-RT
1609          threads simply inherited properties of starting thread instead of
1610          setting their own policy and priority
1611        - minor fix in our automatic stack trace mechanism on crashes, the
1612          main process did not wait for the stack trace process to finish
1613          its output
1614        - fixed some minor memory leaks
1615        - reenabled assembly features support, at the moment only for
1616          enabling a fast denormal FPU mode (x86 platforms supporting SSE2)
1617        - minor assembly fix in x86 features detection (don't use the PIC
1618          register, to avoid relocations in the text segment at runtime)
1619        - POSIX callback functions of Thread.h are hidden
1620    
1621    * MIDI driver:    * MIDI driver:
1622      - dispatch bank select (MSB and LSB) messages      - dispatch bank select (MSB and LSB) messages
# Line 54  Version CVS HEAD (?) Line 1639  Version CVS HEAD (?)
1639      - EG fine tuning: when attack is zero the EG starts at a level      - EG fine tuning: when attack is zero the EG starts at a level
1640        above max sustain level, which means that there is a decay phase        above max sustain level, which means that there is a decay phase
1641        even if sustain is 100%        even if sustain is 100%
1642        - more EG fixes: the level could sometimes go below zero and cause
1643          noises or crashes
1644        - minor fix of EGDecay (patch by Toshi Nagata)
1645        - fixed compiler error when --enable-override-filter-type was
1646          supplied to the configure script (fixes #46)
1647        - disk thread: queue sizes are now proportional to CONFIG_MAX_STREAMS
1648          instead of a fix value
1649        - behavior fix: on MIDI CC# 65 (portamento on / off), 126 (mono mode),
1650          127 (solo mode) only kill voices if the respective mode really
1651          changed
1652    
1653      * LSCP server:
1654        - fixed compile time error for old Bison versions
1655          (i.e. v1.28 found on MacOS 10.4, patch by Toshi Nagata)
1656        - parser now supports extended ASCII character set
1657          (up to ASCII code 255, i.e. includes now umlauts and accents)
1658        - filename arguments in LSCP commands now allow to use escape
1659          sequences, that is directly literal as one of: \', \", \\, \n, \r,
1660          \f, \t, \v, or as octal ASCII code value like \132, or as hex ASCII
1661          code value like \xf2) (fixes bug #24)
1662        - the following LSCP commands now also support escape sequences for at
1663          least one of their text-based parameters (i.e. name, description):
1664          "ADD MIDI_INSTRUMENT_MAP", "MAP MIDI_INSTRUMENT",
1665          "SET MIDI_INSTRUMENT_MAP NAME", "SET FX_SEND NAME", "CREATE FX_SEND",
1666          "SET DB_INSTRUMENT_DIRECTORY NAME",
1667          "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION", "SET DB_INSTRUMENT NAME",
1668          "SET DB_INSTRUMENT DESCRIPTION", "FIND DB_INSTRUMENTS",
1669          "FIND DB_INSTRUMENT_DIRECTORIES"
1670        - returns verbose syntax errors (line and column where syntax error
1671          occured, the unexpected character and the actually expected, possible
1672          character(s), the latter only if less than 5 possibilities)
1673        - made sure that LSCP syntax is not affected by gigedit locale
1674          settings
1675        - bugfix regarding strings parameter lists: all comma separated lists
1676          of strings were treated as being one string containing commas
1677          (fixes #57)
1678    
1679    * Bug fixes:    * Bug fixes:
1680      - fixed crash occurring on certain LSCP scripts (Bug 39)      - fixed crash occurring on certain LSCP scripts (Bug 39)
1681      - another thread safety fix for lscp "load engine" and "set      - another thread safety fix for lscp "load engine" and "set
1682        channel audio output device"        channel audio output device"
1683        - fixed a crash which occurs when reassigning the same engine
1684          on a sampler channel with connected MIDI device
1685        - fixed a crash which occurs when changing the number of ports of a MIDI
1686          device connected to a sampler channel to number less then or equal
1687          to the index of the port to which the sampler channel is connected.
1688        - The previous bindings were not been disconnected when altering
1689          the ALSA_SEQ_BINDINGS parameter. Introduced a NONE keyword for
1690          unsubscribing from all bindings (e.g. ALSA_SEQ_BINDINGS=NONE).
1691        - The active stream/voice count statistic was incorrect.
1692        - notification events were not been sent for some sampler
1693          channel changes
1694        - added default min and max values to restrict the number of allowed
1695          audio output channels and MIDI input ports
1696        - the connection to the PCM interface is now closed when destroying
1697          an audio output device
1698        - files with slash in their path or filename could not be loaded
1699    
1700      * test cases:
1701        - updated and fixed (haven't been touched in a while)
1702    
1703  Version 0.4.0 (24 November 2006)  Version 0.4.0 (24 November 2006)
1704    

Legend:
Removed from v.1130  
changed lines
  Added in v.4010

  ViewVC Help
Powered by ViewVC