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

Diff of /linuxsampler/trunk/ChangeLog

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

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

Legend:
Removed from v.715  
changed lines
  Added in v.3729

  ViewVC Help
Powered by ViewVC