/[svn]/linuxsampler/trunk/ChangeLog

Diff of /linuxsampler/trunk/ChangeLog

Parent Directory | Revision Log | View Patch Patch

-revision 686 by schoenebeck,
Mon Jul 11 19:12:54 2005 UTC
+revision 4016 by schoenebeck,
Mon Jan  3 15:36:02 2022 UTC
 Line 1
- Version CVS HEAD (?)
+ Version SVN trunk (?)
+   * general changes:
+     - AbstractEngineChannel: fixed CCs not being forwarded to all
+       VirtualMIDIDevices.
+     - Fix compiler error with release tarball if no Bison installed
+       (SVN version still requires Flex and Bison being installed).
+   * Real-time instrument scripts:
+     - Fix: Do not share compiled instrument scripts among multiple engine
+       channels (sampler parts) as this can lead to crashes and would allow the
+       same global script variables to be accessible from multiple engine
+       channels which would not be the expected behaviour by instrument script
+       authors.
+   * GigaStudio/Gigasampler format engine:
+     - Use libgig's new IO-per-thread feature to avoid file I/O concurrency
+       issues with .gig file.
+     - Use libgig's new method gig::File::GetSample() with method
+       gig::File::CountSamples() instead of now deprecated
+       gig::File::GetFirstSample() / gig::File::GetNextSample() pair.
+     - Use libgig's new method gig::Instrument::GetRegionAt() with method
+       gig::Instrument:CountRegions() instead of now deprecated
+       gig::Instrument::GetFirstRegion() / gig::Instrument::GetNextRegion() pair.
+     - Use libgig's gig::File::GetInstrument() method with method
+       gig::File::CountInstruments() instead of now deprecated
+       gig::File::GetFirstInstrument() / gig::File::GetNextInstrument() pair.
+     - Show a more detailed error message on terminal if an appropriate editor
+       could not be found for a .gig instrument (if there is not any editor then
+       say so, if there is one but not capable to handle the instrument, then
+       make this case clear to the user; in both cases print the expected
+       location for instrument editor plugins).
+   * SFZ format engine:
+     - Fixed wrong velocity of release triggered samples (most hardware
+       keybaords send note-off with velocyity zero, hence the previous note-on
+       velocity should be used for release triggered samples instead).
+     - sfz.h: Added File::filename() method.
+     - sfz.h: Added File::checkFileModified() method allowing to detect file
+       changes (e.g. by other apps).
+   * MIDI driver:
+     - VirtualMidiDevice: added method Reset() which is e.g. intended to be used
+       in "panic" / MIDI "all sound off" / MIDI "all note off" situations.
+     - VirtualMidiDevice: release all notes on MIDI CC #120 and CC #123.
+ Version 2.2.0 (9 May 2021)
+   * general changes:
+     - Fixed compiler error in Pool.h.
+     - Require C++14 compiler support.
+     - Autoconf: Added m4/ax_cxx_compile_stdcxx.m4 macro which is used
+       for checking in configure for C++14 support (as mandatory
+       requirement) and automatically adds compiler argument if required
+       (e.g. -std=C++14).
+     - RTMath: Implemented floating point comparison methods
+       fEqual32(float,float) and fEqual64(double,double) which take the
+       expected floating point tolerances into account.
+     - Added public API C++ class "LFO", which is a cluster class encapsulating
+       all the sampler's LFO implementations to be used by 3rd party applications
+       (e.g. by Gigedit).
+     - Added int math square LFO implementation.
+     - Added int math saw LFO implementation.
+     - Added numeric complex nr sine LFO implementation.
+     - Marked class LFOTriangleDiHarmonic as deprecated
+       (will be removed in future).
+     - Added LFOAll.h which includes all LFO implementation's header files.
+     - Refactored LFO class names and their file names (PulseLFO -> LFOPulse,
+       LFOSawIntMath -> LFOSawIntMathNew, SawLFO -> LFOSawIntMathOld,
+       SineLFO -> LFOSineBuiltinFn, LFOSine -> LFOSineNumericComplexNr,
+       SquareLFO -> LFOSquarePulse and separated the latter to its own header
+       file).
+     - Renamed type LFOSigned -> LFOTriangleSigned.
+     - Renamed type LFOUnsigned -> LFOTriangleUnsigned.
+     - Using now cubic interpolation as resampling algorithm by default; and
+       linear interpolation is deprecated now.
+     - Event:Init(): memset() entire Event::Param union to zero instead of trying
+       to do that for its individual members; the latter became error prone due
+       to the union's growing complexity meanwhile.
+     - EngineChannel: Overhaul of RPN/NRPN related methods: Added new
+       *Rpn*Parameter*() methods as replacement for previous *Rpn*Controller*()
+       methods and marked the old ones as deprecated; and likewise added new
+       *Nrpn*Parameter*() methods as replacement for previous *Nrpn*Controller*()
+       methods and marked those old ones deprecated as well.
+     - Added support for MIDI CC #38 (data entry LSB): this allows higher value
+       resolution for certain (e.g. hard coded) RPN and NRPN parameters.
+     - Implemented support for compressed RPN/NRPN message sequences (that is to
+       allow processing MIDI data entry messages without always having to be
+       preceded strictly by RPN/NRPN parameter selection messages on each value
+       change).
+     - Added support for MIDI CC #96 (data increment) and MIDI CC #97 (data
+       decrement).
+     - Added support for 'null function RPN/NRPN' (which is RPN/NRPN parameter
+       MSB=127 and LSB=127) and which is disabling subsequent data
+       entry/increment/decrement CC messages.
+     - Fixed crash when editing key groups (a.k.a. exclusive groups) with an
+       instrument editor.
+     - Fixed playing noise at the end of a disk stream under certain conditions.
+     - Fixed potential crash with high pitch at end of RAM playback.
+     - Added configure checks whether C++ compiler supports so called
+       'designated initializers'.
+     - Added global backtraceAsString() function for debugging purposes
+       (POSIX systems only, no Windows implementation yet).
+     - Thread class: Added new methods pushCancelable(), popCancelable(), name(),
+       nameOfCaller() and setNameOfCaller().
+     - configure: Always check for availability of pthread_testcancel() and use
+       it if so (previously it was only used if explicitly enabled by configure
+       option).
+     - Thread class: raise compiler warning if pthread_testcancel() is not
+       available, because it can lead to deadlocks.
+     - Mutex class: Implemented optional bug detection and deadlock debugging
+       features.
+     - Ref<> class is now thread safe (as lock-free and wait-free
+       implementation).
+     - Fixed compilation error with Bison >= 3.6.0.
+     - Fixed rare crash when switching between instruments that had instrument
+       scripts loaded.
+     - Allow EffectChain::InsertEffect() as alternative to
+       EffectChain::AppendEffect() (i.e. with index equal to current chain size).
+     - ConstCapacityArray class: Fixed bug in remove() method.
+     - Fixed crash on certain MIDI RPN and NRPN messages that occurred if no
+       real-time instrument script was loaded.
+   * Real-time instrument scripts:
+     - Added method ScriptVM::setExitResultEnabled() which allows to
+       explicitly enable the built-in exit() function to optionally accept
+       one function argument; the value of the passed exit() function
+       argument will then become available by calling
+       VMExecContext::exitResult() after script execution.
+     - 64 bit support for NKSP integer scripts variables (declare $foo).
+     - Variable names, function names and preprocessor condition names must start
+       with a regular character (a-z or A-Z); starting them with a digit or
+       underscore is not allowed.
+     - NKSP parser fix: equal comparison operator "=" and not equal comparison
+       operator "#" must only accept integer operands.
+     - NKSP language: Implemented support for standard units like Hertz, seconds,
+       Bel including support for metric unit prefixes; so one can now e.g.
+       conveniently use numbers in scripts like "5us" meaning "5 microseconds",
+       or e.g. "12kHz" meaning "12 kilo Hertz", or e.g. "-14mdB" meaning
+       "minus 14 Millidecibel", or e.g. "28c" meaning "28 cents" (for tuning).
+     - NKSP language: Introduced "final" operator "!" which is specifically
+       intended for synthesis parameter values to denote that the synthesis
+       parameter value is intended to be the "final" value for that synthesis
+       parameter that should explicitly be used by the engine and thus causing
+       the sampler engine to ignore all other modulation sources for the same
+       synthesis parameter (like e.g. LFO, EG); by simply prefixing a value,
+       variable or formula with this new "!" operator the expression is marked as
+       being "final".
+     - NKSP script editor API: Added support for detecting standard unit tokens
+       and their potential metric prefix token.
+     - NKSP language: Added support for NKSP real number literals and
+       arithmetic operations on them (e.g. "(3.9 + 2.9) / 12.3 - 42.0").
+     - NKSP language: Added support for NKSP real number (floating point) script
+       variables (declare ~foo).
+     - NKSP language: Added support for NKSP real number (floating point) array
+       script variables (declare ?foo[]).
+     - Built-in script function "message()" accepts now real number argument as
+       well.
+     - Added built-in script function "real_to_int()" and its short hand form
+       "int()" for casting from real number to integer in NKSP scripts.
+     - Added built-in script function "int_to_real()" and its short hand form
+       "real()" for casting from integer to real number in NKSP scripts.
+     - Allow built-in exit() function to potentially accept real number type
+       argument as well.
+     - Built-in script functions may have a different return type depending on
+       the arguments passed to the function.
+     - Built-in script function "abs()" optionally accepts and returns real
+       number.
+     - Built-in script functions "min()" and "max()" optionally accept real
+       number arguments and return real number as result in that case.
+     - NKSP VM API: Allow units and 'final'ness to be returned as result from
+       built-in functions (added methods VMFunction::returnUnitType() and
+       VMFunction::returnsFinal() for that purpose which must be implemented by
+       built-in function implementations).
+     - NKSP language: Allow metric unit prefixes of numeric scalar and array
+       variables to be changed freely at runtime (unlike unit types like Hz etc.
+       which are still sticky, parse-time features of variables which cannot be
+       changed at runtime for the intentional sake of determinism).
+     - NKSP language: 'final' values are prohibited for array variables for now
+       (attempt causes a parsers error).
+     - NKSP language: expressions with unit types (e.g. Hz) are prohibited for
+       conditions of runtime control structures like if(), while(), select()
+       (attempt causes a parser error).
+     - NKSP VM API: Allow built-in functions to perform their own, individual
+       parse time checks of arguments going to be passed to the function at
+       runtime (added method VMFunction::checkArgs() for that purpose).
+     - NKSP language: raise parser warning if only one operand of binary
+       operators (like logical 'or' comparison) contain a 'final' value (because
+       it would always yield in a 'final' result in such cases).
+     - NKSP language: Allow comparison (=, #, <, >, <=, >=) of values with
+       different metric unit prefixes, which will behave as expected (e.g.
+       result of expression '1000us < 2ms' is true).
+     - NKSP language: Allow adding values with different metric unit prefixes
+       (e.g. result of expression '100Hz + 5kHz' is '5100Hz').
+     - NKSP language: Allow subtracting values with different metric unit
+       prefixes (e.g. result of expression '1ms - 20us' is '980us').
+     - NKSP language: Allow multiplying with any metric unit prefixes
+       (e.g. result of expression '2k * 3ms' is '6s'), however multiplications
+       with unit types on both sides (e.g. '2s * 2s') is still prohibited since
+       we don't have any considerable practical use for a term like '4s^2'
+       (hence any attempt multiplying two unit types still causes parser error).
+     - NKSP language: Allow dividing by any metric unit prefixes and allow
+       division of same unit type on both sides (e.g. expression '8kHz / 1000Hz'
+       yields in unit free result '8'). So this is now a way to cast units away
+       e.g. for passing the result to other expressions, certain function calls
+       or variables which are not accepting any units (or that specific unit).
+     - NKSP language: integer arrays and real number arrays can now be converted
+       to strings (e.g. for dumping their content with message() calls for
+       script debugging purposes).
+     - NKSP language: expressions and variables with units are now correctly
+       casted to strings (e.g. with message() calls).
+     - NKSP language: comparing real numbers for equalness (e.g. '~foo = 3.1') or
+       unequalness (e.g. '~foo # 3.1') is now less strict and takes the expected
+       floating point tolerances into account.
+     - NKSP VM API: Added methods VMScalarNumberExpr::evalCastInt() and
+       VMScalarNumberExpr::evalCastReal().
+     - NKSP VM API: Added base class 'VMNumberArrayExpr' for classes
+       'VMIntArrayExpr' and 'VMRealArrayExpr'.
+     - NKSP VM API: replaced all unitPrefix() (parse time) methods by
+       unitFactor() (runtime) methods.
+     - Built-in function "exit()" supports now returning units and 'final'ness
+       for test cases.
+     - The following built-in functions support now units as well: "abs()",
+       "random()", "inc()", "dec()", "in_range()", "min()", "max()",
+       "real_to_int()", "int()", "int_to_real()" and "real()".
+     - Built-in functions "array_equal()", "search()" and "sort()" support now
+       real number arrays (correctly) as well.
+     - Added individual parse time checks of arguments to be passed to built-in
+       functions "random()", "inc()", "dec()", "in_range()", "min()", "max()",
+       "array_equal()" and "search()" specific for their individual purposes.
+     - NKSP VM refactoring: Renamed all methods, functions and classes matching
+       pattern *ScalarNumber* to simply *Number* (that is i.e. classes
+       VMScalarNumberExpr -> VMNumberExpr, ScalarNumberExpr -> NumberExpr,
+       ScalarNumberVariable -> NumberVariable, ScalarNumberBinaryOp ->
+       NumberBinaryOp, VMScalarNumberResultFunction -> VMNumberResultFunction,
+       method VMExpr::asScalarNumberExpr() -> VMExpr::asNumber(), function
+       isScalarNumber() -> isNumber()).
+     - NKSP VM API: Added 4 overridden methods to class VMNumberExpr:
+       evalCastInt(MetricPrefix_t), evalCastInt(MetricPrefix_t,MetricPrefix_t),
+       evalCastReal(MetricPrefix_t), evalCastReal(MetricPrefix_t,MetricPrefix_t)
+       as convenient methods for automatically converting values to expected
+       metric value basis.
+     - Built-in function "wait()" accepts now both integers and real numbers as
+       argument.
+     - NKSP VM API cleanup: Get rid of legacy method
+       VMFunction::argType(vmint iArg) which was already superseded by its new
+       replacement VMFunction::acceptsArgType(vmint iArg, ExprType_t type).
+     - NKSP parser: if wrong argument type was passed to a built-in function and
+       that built-in function accepts more than one data type for the argument,
+       then show all supported data types as parser error message.
+     - Built-in function "play_note()" accepts now real numbers and seconds as
+       unit type as well for its 3rd and 4th function arguments.
+     - The following built-in functions accept now real numbers as well for their
+nd function argument: "change_vol()", "change_tune()", "change_cutoff()",
+       "change_attack()", "change_decay()", "change_release()",
+       "change_sustain()", "change_cutoff_attack()", "change_cutoff_decay()",
+       "change_cutoff_sustain()", "change_cutoff_release()",
+       "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
+       "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
+       "change_pan_time()", "fade_in()", "fade_out()", "change_play_pos()".
+     - Fixed built-in function "change_play_pos()" not having accepted metric
+       prefixes at all.
+     - Fixed the following built-in functions having misinterpreted values given
+       with unit type (for their 2nd argument) as if they were relative values
+       (that is as if they were passed without a unit type): "change_attack()",
+       "change_decay()", "change_release()", "change_cutoff_attack()",
+       "change_cutoff_decay()", "change_cutoff_release()".
+     - Fixed the following built-in functions having applied completely wrong
+       'final' values: "change_sustain()", "change_cutoff_sustain()" (since the
+       respective EGs being their modulation sink assume uint data type with
+       value range 0..1000 instead of 0.0..1.0.
+     - Added individual parse-time checks of function arguments for the following
+       built-in functions: "play_note()", "note_off()", "set_event_mark()",
+       "delete_event_mark()", "by_marks()", "change_cutoff()", "change_attack()",
+       "change_decay()", "change_release()", "change_cutoff_attack()",
+       "change_cutoff_decay()", "change_cutoff_release()",
+       "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
+       "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()" and
+       "change_pan_time()".
+     - Don't abort function call if unit type was used and at the same time
+       'final' operator was omitted for the primary value argument of the
+       following built-in functions: "change_cutoff()", "change_attack()",
+       "change_decay()", "change_release()", "change_cutoff_attack()",
+       "change_cutoff_decay()", "change_cutoff_release()",
+       "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
+       "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
+       "change_pan_time()", instead imply 'final'ness at runtime and raise an
+       appropriate parser warning at parse time.
+     - Added built-in real number functions "round()", "ceil()", "floor()",
+       "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()", "sin()",
+       "cos()", "tan()", "asin()", "acos()", "atan()".
+     - Added built-in script real number constant "~NI_MATH_PI".
+     - Added built-in script real number constant "~NI_MATH_E".
+     - NKSP language: Allow unary '+' operator.
+     - Added built-in script functions "msb()" and "lsb()".
+     - NKSP language: Added support for RPN event handler
+       ("on rpn ... end on" in instrument scripts).
+     - NKSP language: Added support for NRPN event handler
+       ("on nrpn ... end on" in instrument scripts).
+     - Added built-in read-only variables "$RPN_ADDRESS" and "$RPN_VALUE" which
+       may be read from the new RPN/NRPN script handlers to get the (N)RPN
+       parameter that had been changed and its new value.
+     - Added built-in const variables "$NI_CB_TYPE_RPN" and "$NI_CB_TYPE_NRPN"
+       which are identifying the new (N)RPN handlers as such at script runtime.
+     - Implemented built-in script function "set_rpn()".
+     - Implemented built-in script function "set_nrpn()".
+     - Fix: built-in functions returning an array type were broken and caused a
+       crash when the built-in function's (supposed to be array) result value was
+       used by the script VM.
+     - Removed upper value constraint for 2nd argument of built-in functions
+       "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
+       "change_pitch_lfo_freq()","change_reso()", "change_cutoff()",
+       "change_amp_lfo_depth()", "change_cutoff_lfo_depth()" and
+       "change_pitch_lfo_depth()", to allow e.g. passing value 2000000 to double
+       the LFO frequency / resonance / cutoff frequency.
+     - Reduced code involved for parsing NKSP variable declarations by using 2
+       generalized grammar rules with optional components (i.e. optional value
+       assignment and optional variable qualifiers) instead of previous linear
+       combinations of grammar rules, which also fixes some edge case.
+     - NKSP language parser: track code block locations also by a) raw byte
+       position in NKSP source code string and b) length of that code block in
+       bytes (along to the already existing code block tracking by line/column);
+       and added appropriate new members to public C++ API classes like
+       'firstByte' and 'lengthBytes' to class VMSourceToken and struct CodeBlock.
+     - NKSP language: Added support for 'patch' variable qualifier (capture their
+       locations and allow replacement of their assignment expression via VM C++
+       API).
+     - Fixed incorrect EG times if standard measuring unit was passed to built-in
+       functions "change_attack()", "change_decay()" or "change_release()".
+     - Fixed intermediate function result values never having reflected any
+       standard measuring unit type.
+     - Fixed re-entrant issue with function calls which caused wrong result
+       values if the same function was called multiple times in a term
+       (specifically if metric prefixes were used).
+     - NKSP language: Just throw a warning, not an error if an array variable of
+       size zero was declared.
+     - NKSP language: Allow omitting explicit array size on array variable
+       declaration if combined with immediate value assignment
+       (e.g. declare %foo[] := ( 1, 2, 3 ) ).
+     - NKSP language: emit warning if an array variable was declared with bigger
+       array size than amount of initial values been assigned, and initialize the
+       missing array elements with zero in this case.
+     - Fixed built-in NKSP exit() function to behave as return statement.
+     - NKSP parser: Fixed crash if unary '-' operator was used on a non-number
+       data type.
+     - NKSP VM: Fixed the "release" handler being executed too often under
+       certain situations if polyphonic data was passed from "note" handler to
+       "release" handler.
+     - Fixed memory leak in NKSP parser: string tokens were allocated as C
+       strings and never freed.
+     - Fixed incorrect polyphonic data transfer from wrong note handler to
+       release handler; which also fixes no release handler being executed
+       sometimes, and due to the latter it also fixes potential crashes as some
+       polyphonic script events were never released and the engine hence was
+       running out of free script events.
+     - Fixed crash when handling array results of built-in functions
+       (e.g. "num_elements(by_marks($MARK_1)").
+     - NKSP VM: Fixed dead note events not been removed from user's event groups
+       (i.e. causing incorrect behaviour of built-in NKSP functions by_marks()
+       and set_event_mark() after max. size of event group list was exhausted).
+   * test cases:
+     - Fixed compiler errors in test cases.
+     - Updated README for how to compile & run test cases.
+     - Updated test case
+       MutexTest::testDoubleLockStillBlocksConcurrentThread() to latest
+       expected behaviour of the Mutex class implementation (recursive
+       mutex type).
+     - Added test cases for NKSP core language aspects and core built-in
+       functions.
+     - Fixed thread tests segfaulting on Linux.
+     - NKSP: Added real number test cases for built-in functions exit(),
+       int_to_real(), real(), real_to_int() and int(), as well as for the
+       plus, minus and negate language operators.
+     - Added massive amount of NKSP test cases for standard measuring units and
+       'final' operator usage cases.
+     - Added NKSP test cases for (floating point tolerance aware) real number
+       equalness / unequalness comparison.
+     - Added NKSP int array and real array tests for value assignment and
+       initialization of arrays.
+     - Added NKSP test cases for built-in functions "round()", "ceil()",
+       "floor()", "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()",
+       "sin()", "cos()", "tan()", "asin()", "acos()", "atan()".
+     - Added NKSP test cases for unary '+' operator.
+     - Added NKSP test cases for core built-in variables.
+     - Added thorough NKSP test cases for variable declarations.
+   * GigaStudio/Gigasampler format engine:
+     - LFOTriangleIntMath and LFOTriangleIntAbsMath: Fixed FlipPhase=true
+       behaviour for start_level_mid.
+     - Changed LFO start levels: LFO1 and LFO2 both to mid, LFO3 to max. start
+       level (see discussion "GigaStudio LFO compatibility" on mailing list
+       from 2019-09-26 for details).
+     - Changed default wave form for all 3 LFOs to sine (instead of triangle;
+       see discussion "GigaStudio LFO compatibility" on mailing list from
+-09-26 for details).
+     - Format extension: Added support for different LFO wave forms (currently
+       either sine [default], triangle, saw or square).
+     - Format extension: Added support for LFO phase displacement (0°..360°).
+     - Format extension: Added support for flipping LFO polarity on LFO 3
+       (in the original gig format this was only available for LFO 1 and LFO 2).
+     - Format extension: Support for additional filter types:
+       lowpass 1/2/4/6-pole, highpass 1/2/4/6-pole, bandpass 2-pole,
+       bandreject 2-pole.
+     - Fixd potential crash with polynomial interpolator and max. pitch.
+     - If minimum cutoff is defined, remap cutoff controller CC values to really
+       span the entire possible cutoff range (and avoiding a dead controller
+       zone).
+     - Implemented support for loading instrument scripts with 'patch' variables
+       (by patching these script variables with potentially overridden ones by
+       gig Instrument).
+   * SFZ format engine:
+     - Fixed support for regions with loccN/hiccN conditions on more than one
+       MIDI controller.
+     - Fixed internal opcode 'xfin_hivel' falsely being set by user opcode
+       'xfin_lovel' (patch by Christian Czezatke).
+   * Benchmarks:
+     - Fixed benchmarks/triang.cpp falsely having favoured "int math abs"
+       algorithm (since result of 2nd run was not accumulated).
+     - Added benchmark for saw wave (benchmarks/saw.cpp).
+     - Added benchmark for sine wave (benchmarks/sine.cpp).
+     - Added benchmark for square wave (benchmarks/square.cpp).
+     - Increased amount of benchmarks runs by factor 6 to achieve benchmark times
+       which are large enough on modern systems.
+ Version 2.1.1 (27 Jul 2019)
+   * Real-time instrument scripts:
+     - Fixed behavior of built-in NKSP functions change_sustain(),
+       change_cutoff_attack(), change_cutoff_decay(), change_cutoff_sustain()
+       and change_cutoff_release().
+   * general changes:
+     - Only play release trigger samples on sustain pedal up if this behaviour
+       was explicitly requested by the instrument (otherwise only on note-off).
+     - Fixed compiler warnings.
+     - Fixed compilation error when cross-compiling to Mac.
+     - FX Sends: Provide more useful error messages on routing problems
+       (see bug #169).
+     - LSCP doc: Be more clear describing the two distinct approaches
+       of using external vs. internal effects (see bug #169).
+     - "optional" class: Fixed comparison operators.
+   * Gigasampler/GigaStudio format engine:
+     - Format extension: If requested by instrument then don't play release
+       trigger sample on note-off events.
+   * SFZ format engine:
+     - Fixed memory leak when releasing samples
+       (fixes bug #307, patch by Jacek Roszkowski)
+     - Fixed potential crash when a sample is shared by more than one region
+       (fixes bug #308, patch by Jacek Roszkowski).
+     - Opcode 'sample': Added support for built-in sample '*silence'
+       (fixes bug #310, patch by Jacek Roszkowski).
+ Version 2.1.0 (25 Nov 2017)
+   * SFZ format engine:
+     - added support for <global>, <master> and #define (patch by Alby M)
+     - Removed code duplication in SFZ file loading code.
+     - Added support for sfz extension opcode 'script' which may be used to
+       load real-time instrument script file (NKSP script language).
+     - Implemented opcode set_ccN (initial patch by Giovanni Senatore).
+     - Fixed unintended volume fade-in of voices under certain conditions.
+     - sfz parser: allow missing space between header and opcode
+   * Gigasampler/GigaStudio format engine:
+     - Fixed clicks and pumping noise with Lowpass Turbo filter on very low
+       cutoff settings.
+     - Got rid of resembling an ancient GSt misbehavior which did not pitch at
+       all if an up-pitch of more than 40 semi tones was requested (I don't
+       think there is any stock gig sound that requires this behavior to
+       resemble its original sound).
+     - Added support for controlling whether the individual EGADSR stages may
+       be aborted (as LinuxSampler extension to the original GigaStudio 4
+       format).
+   * general changes:
+     - fixed printf type errors (mostly in debug messages)
+     - use unique_ptr instead of auto_ptr when building with C++11
+     - Added RTAVLTree class which is a real-time safe ordered multi-map, thus
+       allowing to sort data efficiently in real-time safe manner.
+     - RTList class: added methods for moving/inserting elements to arbitrary
+       position within a list.
+     - RTList class: added method fromPtr() for creating an Iterator object from
+       a raw element pointer.
+     - Attempt to partly fix resetting engine channels vs. resetting engine, an
+       overall cleanup of the Reset*(), ConnectAudioDevice(),
+       DisconnectAudioDevice() API methods would still be desirable though,
+       because the current situation is still inconsistent and error prone.
+     - Active voices are now internally grouped to "Note" objects, instead of
+       being directly assigned to a keyboard key. This allows more fine graded
+       processing of voices, which is i.e. required for certain instrument
+       script features.
+     - Fix: Release trigger voices were not spawned on sustain pedal up
+       (CC #64) events.
+     - Fix: Release trigger voices can now also distinguish correctly between
+       note-off and sustain pedal up events.
+     - All engines: Increased ramp speed of volume smoother and pan smoother
+       (while slow rate of crossfade smoother is preserved) to allow quick
+       volume and pan changes by instrument scripts for instance.
+     - gig/sf2/sfz: Fixed aftertouch channel pressure events being processed
+       properly and thus were ignored for certain uses.
+     - Added new C++ API method
+       VirtualMidiDevice::SendChannelPressureToSampler().
+     - windows, 32-bit: fixed potential crashes by making sure the stack in
+       sub threads is 16-byte aligned
+     - fixed numerous compiler warnings
+     - Fixed invalid (note-on) event ID being assigned to new Note objects.
+     - Revised fundamental C++ classes "Thread", "Mutex" and "Condition" which
+       fixes potential undefined behavior.
+     - Fixed Note object leak when triggering notes on keys which did not
+       have a valid sample mapped (fixes bug #252).
+     - Fixed compilation errors when compiling with CONFIG_DEVMODE enabled.
+     - linuxsampler binary fix: option --create-instruments-db ignored
+       subsequent optional argument due to glibc's implementation oddity
+       which expects a "=" sign, but no space between them.
+   * packaging changes:
+     - removed unnecessary dependency to libuuid
+       (originated by libgig's usage of it)
+     - Automake: set environment variable GCC_COLORS=auto to allow GCC to
+       auto detect whether it (sh/c)ould output its messages in color.
+     - Debian: Fixed packaging error about invalid "Source-Version"
+       substitution variable.
+     - Debian: Raised Debian compatibility level to Debian 9 "Stretch".
+     - Debian: Added build dependency to libsqlite3-dev for building
+       linuxsampler with instruments DB support.
+   * Real-time instrument scripts:
+     - Implemented scheduler for delayed MIDI events and for suspended scripts.
+     - Built-in script function "wait()": implemented support for function's
+       "duration-us" argument, thus scripts using this function are now
+       correctly resumed after the requested amount of microseconds.
+     - Built-in script function "play_note()": implemented support for
+       function's "duration-us" argument, thus notes triggered with this
+       argument are now correctly released after the requested amount of
+       microseconds.
+     - Fix: script events were not cleared when engine channel was reset,
+       potentially causing undefined behavior.
+     - Fixed crash which happened when trying to reference an undeclared
+       variable.
+     - Built-in script function "play_note()": Added support for passing
+       special value -1 for "duration-us" argument, which will cause the
+       triggered note to be released once the original note was released.
+     - Instrument script classes now exported with the liblinuxsampler C++ API.
+     - Added new API method ScriptVM::syntaxHighlighting() which provides
+       a convenient syntax highlighting backend for external instrument
+       script editor applications.
+     - Added new C++ API class "ScriptVMFactory".
+     - Extended parser issues to provide not only first line and first
+       column, but also last line and last column of issue (thus marking
+       the precise span of the issue within the source code).
+     - Reload script automatically after being modified by an instrument
+       editor.
+     - NKSP language grammar correction: allow empty event handler bodies
+       like "on note end on".
+     - Implemented built-in script function "change_vol()".
+     - Implemented built-in script function "change_tune()".
+     - Implemented built-in script function "change_pan()".
+     - Implemented built-in script function "change_cutoff()".
+     - Implemented built-in script function "change_reso()".
+     - Implemented built-in script function "event_status()".
+     - Added built-in script constants "$EVENT_STATUS_INACTIVE" and
+       "$EVENT_STATUS_NOTE_QUEUE" both for being used as flags for
+       "event_status()" function.
+     - NKSP language: Added support for bitwise operators ".or.", ".and."
+       and ".not.".
+     - NKSP language scanner: Fixed IDs matching to require at least one
+       character (i.e. when matching function names or variable names).
+     - NKSP language scanner: disabled unusued rules.
+     - Fixed behavior of play_note() and note_off() functions which must
+       be distinguished engine internally from "real" MIDI note on/off
+       events in order to avoid misbehaviors like hanging notes.
+     - Implemented built-in script variable "$KSP_TIMER".
+     - Implemented built-in script variable "$NKSP_REAL_TIMER".
+     - Implemented built-in script variable "$NKSP_PERF_TIMER".
+     - Implemented built-in script variable "$ENGINE_UPTIME".
+     - Implemented built-in script function "inc()".
+     - Implemented built-in script function "dec()".
+     - NKSP language fix: division expressions were evaluated too often.
+     - NKSP language fix: string concatenation operator was right
+       associative instead of left (to right).
+     - NKSP language correction: allow empty statements in entire language
+       (i.e. "if end if").
+     - Implemented built-in script function "stop_wait()".
+     - Implemented built-in script variable "$NI_CALLBACK_ID".
+     - Implemented built-in script variable "$NI_CALLBACK_TYPE".
+     - Implemented built-in script variable "$NKSP_IGNORE_WAIT".
+     - Added support for read-only built-in variables (respectively
+       handled by the script parser).
+     - Added built-in script constant "$NI_CB_TYPE_INIT".
+     - Added built-in script constant "$NI_CB_TYPE_NOTE".
+     - Added built-in script constant "$NI_CB_TYPE_RELEASE".
+     - Added built-in script constant "$NI_CB_TYPE_CONTROLLER".
+     - NKSP Language: Added support for user defined script functions.
+     - Implemented built-in script function "change_attack()".
+     - Implemented built-in script function "change_decay()".
+     - Implemented built-in script function "change_release()".
+     - Fixed all change_*() built-in script functions to apply their
+       synthesis parameter changes immediately in case the respective note
+       was triggered at the same time, instead of scheduling the parameter
+       change, especially because it would cause some parameter types's
+       changes either to be ramped (i.e. change_vol()) or other types even
+       to have not effect at all (i.e. change_attack()).
+     - Implemented built-in script function "sh_left()".
+     - Implemented built-in script function "sh_right()".
+     - Implemented built-in script function "min()".
+     - Implemented built-in script function "max()".
+     - NKSP Fix: "init" event handler was not always executed when a script
+       was loaded.
+     - NKSP built-in wait() script function: abort script execution if
+       a negative or zero wait time was passed as argument (since this is
+       a common indication of a bug either of the script or even of the
+       engine, which could lead to RT instability or even worse).
+     - ScriptVM: Implemented automatic suspension of RT safety
+       threatening scripts.
+     - Provide more user friendly error messages on syntax errors.
+     - Fixed NKSP parser warning "Not a statement" when assigning an
+       initializer list to an array variable.
+     - Implemented built-in script array variable "%ALL_EVENTS".
+     - Implemented built-in script function "in_range()".
+     - Implemented built-in script function "change_amp_lfo_depth()".
+     - Implemented built-in script function "change_amp_lfo_freq()".
+     - Implemented built-in script function "change_pitch_lfo_depth()".
+     - Implemented built-in script function "change_pitch_lfo_freq()".
+     - Implemented built-in script function "change_vol_time()".
+     - Implemented built-in script function "change_tune_time()".
+     - Implemented built-in script function "fade_in()".
+     - Implemented built-in script function "fade_out()".
+     - Fixed acceptance of wrong data type of parameters passed to built-in
+       script functions "change_vol()", "change_tune()", "change_pan()",
+       "change_cutoff()", "change_reso()", "change_attack()", "change_decay()",
+       "change_release()", "change_amp_lfo_depth()", "change_amp_lfo_freq()",
+       "change_pitch_lfo_depth()" and "change_pitch_lfo_freq()".
+     - Added built-in script function "get_event_par()" and implemented some
+       of its possible parameter selections.
+     - Added built-in script function "set_event_par()" and implemented some
+       of its possible parameter selections.
+     - Fixed a bunch of scheduler time related bugs.
+     - Fixed polyphonic variables not being reset to zero after usage.
+     - Built-in "ignore_event()" function: argument is now optional, like with
+       built-in function "ignore_controller()".
+     - Implemented built-in script function "change_velo()".
+     - Implemented built-in script function "change_note()".
+     - Adjusted behavior of "change_vol()" and "change_tune()" to a more
+       intuitive behavior if used in combination with "change_vol_time()" or
+       "change_tune_time()" respectively: now tuning/volume changes are only
+       assigned (without delay) immediately to a new note if the respective
+       timing function has not been called before, otherwise the volume/tuning
+       changes are automatically faded (before, only the event's time stamp was
+       relevant).
+      - Implemented built-in script function "array_equal()".
+      - Implemented built-in script function "search()".
+      - Implemented built-in script function "sort()".
+      - NKSP Fix: Never suspend "init" event handlers.
+      - Implemented built-in script function "same_region()" (currently only
+        available for gig format engine).
+      - Added built-in script constant "$NKSP_LINEAR".
+      - Added built-in script constant "$NKSP_EASE_IN_EASE_OUT".
+      - Implemented built-in script function "change_vol_curve()".
+      - Implemented built-in script function "change_tune_curve()".
+      - built-in "play_note()" function now supports a sample playback start
+        offset with argument 3, where special value -1 means to use the regular
+        sample offset as defined by the instrument file.
+      - Built-in array variable %KEY_DOWN[] is now a read-only variable.
+      - Built-in variable $EVENT_NOTE is now a read-only variable.
+      - Built-in variable $EVENT_VELOCITY is now a read-only variable.
+      - built-in "play_note()" function now accepts -2 for its fourth argument
+        (note duration) which means the life time of the note shall be sticked
+        to the requested note number of argument 1.
+      - Fix: built-in "play_note()" function now returns 0 as result value if
+        -1 was passed for its fourth argument (note duration) and the respective
+        parent note is already gone.
+     - Implemented built-in script function "change_play_pos()".
+     - NKSP language: Added support for user declared const array variables.
+     - NKSP language: Raise parser warning if array variable is accessed with
+       an index that exceeds the array's size.
+     - NKSP language fix: Unknown characters were not handled correctly.
+     - NKSP language: Added support for "synchronized .. end synchronized"
+       code blocks.
+     - Implemented built-in script function "abort()" which allows to abort
+       another script handler by passing its callback ID.
+     - Fixed potential memory access bug and potential undefined behavior of
+       "init" event handlers.
+     - Print a time stamp along to each call of built-in function "message()".
+     - ScriptVM API: Added VMParserContext::preprocessorComments() which allows
+       to retrieve all code blocks filtered out by the preprocessor.
+     - Added built-in script function "fork()".
+     - Added built-in array variable %NKSP_CALLBACK_CHILD_ID[].
+     - Added built-in variable $NKSP_CALLBACK_PARENT_ID.
+     - Fixed potential crash when accessing dynamic built-in array variables.
+     - Added built-in script function "callback_status()".
+     - Added built-in constant $CALLBACK_STATUS_TERMINATED.
+     - Added built-in constant $CALLBACK_STATUS_QUEUE.
+     - Added built-in constant $CALLBACK_STATUS_RUNNING.
+     - Removed max. value limitation of built-in functions "change_attack()",
+       "change_decay()" and "change_release()" to i.e. allow passing 2000000
+       for doubling the respective time.
+     - NKSP script editor syntax highlighting API: Fixed app termination due
+       to a lexer start condition stack underrun.
+     - NKSP preprocessor: Fixed wrong behavior on nested USE_CODE_IF() and
+       USE_CODE_IF_NOT() preprocessor statements.
+     - NKSP: Added built-in preprocessor condition NKSP_NO_MESSAGE, which
+       can be set to disable all subsequent built-in "message()" function calls
+       on preprocessor level.
+     - Implemented built-in script function "change_sustain()".
+     - NKSP script editor syntax highlighting API: catch all fatal lexer errors,
+       to avoid the editor app to crash on ill-formed text input.
+     - Added built-in script function "change_pan_time()".
+     - Added built-in script function "change_pan_curve()".
+     - Added built-in script function "change_cutoff_attack()".
+     - Added built-in script function "change_cutoff_decay()".
+     - Added built-in script function "change_cutoff_sustain()".
+     - Added built-in script function "change_cutoff_release()".
+     - Added built-in script function "change_cutoff_lfo_depth()".
+     - Added built-in script function "change_cutoff_lfo_freq()".
+   * Instruments DB:
+     - Fixed memory access bug of general DB access code which lead to
+       undefined behavior.
+     - Cleanup of instruments DB file creation and opening code.
+     - The instrument DB path of linuxsampler's --create-instruments-db argument
+       is now optional, if it is missing, then a default location is used.
+     - Added support for scanning SFZ (.sfz) files.
+     - Added support for scanning Sound Font (.sf2) files.
+     - Fixed undefined DB transaction behavior.
+ Version 2.0.0 (15 July 2015)
+   * packaging changes:
+     - fixed building with newer MinGW-w64
+     - Mac OS X: support the new dir for Core Audio SDK
+     - Mac OS X: fixed building outside source directory
+     - made sure all source files for hostplugins are included when
+       doing "make dist"
+     - removed empty directories left from the cvs to svn migration
+     - fixed compilation with gcc 4.6.1
+     - another "make dist" fix, for the LV2 plugin
+     - made --enable-pthread-testcancel default on Mac OS X
+     - minor Makefile fix for building lscpparser when build and source
+       directories are separate
+     - Mac OS X: made it possible to specify plugin installation dir to
+       configure
+     - Mac OS X: Makefile fix for the install-strip target
+     - fixed compilation with gcc 4.7
+     - fixed configure script error with old autoconf versions
+     - lsatomic.h: use gcc provided atomic functions if building with
+       gcc 4.7 and C++11
+     - modernized configure script
+     - fixed linkage error when building with
+       LDFLAGS="-Wl,--no-undefined" (#190)
+     - fixed compilation with Clang 3.2
+     - removed usage of deprecated Automake variable INCLUDES
+     - fixed building with C++11
+     - build fix: ChangeFlagRelaxed.h was missing in makefile
+     - build fix: libsndfile compiler flags were missing in some
+       makefiles
+     - fix for building with bison 3.0 (#202)
+     - Mac OS X: added temporary hack allowing to spawn gigedit as callback
+       on the process's main thread
+     - fixed build error on newer MinGW
+     - support building with older jack versions
+     - support building with spaces in vst sdk path
+     - enabled automake 'subdir-objects' option and moved external
+       source references (vst, au, asio) from makefiles to cpp files,
+       in order to get rid of warnings from automake 1.14
+   * general changes:
+     - Refactoring: moved the independent code from
+       the Gigasampler format engine to base classes
+     - command line option '--profile' is currently disabled, since the
+       respective profiling code is currently broken
+     - Introduced support for optional environment variable
+       "LINUXSAMPLER_PLUGIN_DIR" which allows to override the directory
+       where the sampler shall look for instrument editor plugins
+       (patch by Luis Garrido, slightly modified).
+     - implemented Roland GS NRPN 1ArrH which allows to set volume per note
+     - implemented Roland GS NRPN 1CrrH which allows to set pan per note
+     - implemented Roland GS NRPN 1DrrH which allows to set reverb send per
+       note (in this implementation of the sampler its simply hard routed to
+       the 1st effect send of the sampler channel, no matter what the actual
+       effect type is)
+     - implemented Roland GS NRPN 1ErrH which allows to set chorus send per
+       note (in this implementation of the sampler its simply hard routed to
+       the 2nd effect send of the sampler channel, no matter what the actual
+       effect type is)
+     - implemented support for internal LADSPA effects
+     - raised limit of program change queue from 100 to 512
+       (as suggested by Alex Stone)
+     - implemented sine LFO, pulse LFO and saw LFO
+     - experimental support for per voice equalization
+     - added command line option --exec-after-init
+     - Introduced new C++ API method:
+       EngineChannel::InstrumentFileName(int index)
+       allowing to retrieve the whole list of files used for the loaded
+       instrument on an engine channel (a.k.a. part). Some GigaStudio
+       instruments for example are splitted over several files like
+       "Foo.gig", "Foo.gx01", "Foo.gx02", ...
+     - Added new C++ API method Sampler::GetGlobalMaxVoices().
+     - Added new C++ API method Sampler::GetGlobalMaxStreams().
+     - Added new C++ API method Sampler::SetGlobalMaxVoices().
+     - Added new C++ API method Sampler::SetGlobalMaxStreams().
+     - Various "const" and "restrict" optimizations.
+     - all engines: add pan CC value to instrument pan parameter before
+       applying panning, instead of using two separate pan functions in
+       series (#182)
+     - added a lock guard class for exception safe mutex handling and
+       used it everywhere appropriate
+     - Immediately apply scale tuning changes to active voices.
+     - Exposed scale tuning to C++ API (along to the already existing standard
+       SysEx way).
+     - lsatomic.h fixes: seq_cst load and store were suboptimal for x86
+       and broken for ppc64. (Seq_cst loads and stores are actually not
+       used in LS, so the bug wasn't noticable.)
+     - lsatomic.h: added ARMv7 support
+     - Added support for multiple MIDI input ports per sampler channel (and
+       added various new C++ methods for this new feature / design change, old
+       C++ API methods for managing SamplerChannel's MIDI inputs are now marked
+       as deprecated but are still there and should provide full behavior
+       backward compatibility).
+     - AbstractEngine::GSChecksum(): don't allocate memory on the stack (was
+       unsafe and caused compilation error with clang 2.x).
+     - Bugfix: only process the latest MIDI program change event.
+     - Introducing the LSCP shell, which provides convenient control of the
+       sampler from the command line by providing LSCP aware features.
+     - VirtualMidiDevice: Added support for program change.
+     - VirtualMidiDevice: Added support for bank select (MSB & LSB).
+     - VirtualMidiDevice: Added support for pitch bend.
+     - Aftertouch: extended API to explicitly handle channel pressure and
+       polyphonic key pressure events (so far polyphonic pressure was not
+       supported at all, and channel pressure was rerouted as CC128 but not
+       used so far).
+     - Added initial support for real-time instrument scripts. The script VM
+       code is shared by all sampler engine implemementations, however only the
+       gig file format currently provides support for storing instrument scripts
+       (as LinuxSampler extension to the original GigaStudio 4 format).
+   * Gigasampler format engine:
+     - implemented the "round robin keyboard" dimension
+     - fixed round robin and random dimensions for cases when number of
+       dimension zones is not a power of two
+     - made round robin use a counter for each region instead of each
+       key
+     - bugfix: pitch LFO controller "internal+aftertouch" was broken
+     - bugfix: filter keyboard tracking was broken
+     - filter performance fix (an unnecessary copy was made of the
+       filter parameters in each sub fragment)
+     - handle special case when pan parameter in gig file has max or
+       min value
+     - Exclusive Groups: don't ever stop voices of the same note,
+       doesn't sound naturally with a drumkit
+     - fixed EG1 modulation when attack or release is zero
+     - Fixed support for 'aftertouch' attenuation controller.
+     - Fixed crash that happened with velocity split sounds under certain
+       conditions (see also previous commit on libgig).
+     - fixed behaviour of filter LFO
+   * SFZ format engine:
+     - Initial implementation (not usable yet)
+     - added support for v2 multiple stage envelope generators
+     - added a fine-tuned v1 envelope generator instead of using the
+       one from the gig engine
+     - fixed memory leak and memory handling errors
+     - added support for trigger=first, trigger=legato and sw_previous
+     - allow non-numerical key values ("C#4" for example)
+     - "key" opcode now sets pitch_keycenter too
+     - fixed error when unloading instrument with same sample used by
+       multiple regions
+     - added some opcode aliases, like loopmode for loop_mode, to be
+       more compatible
+     - added support for trigger=release and rt_decay
+     - added support for off_mode=normal
+     - added support for random, seq_position, seq_length and volume
+     - added v1 LFO opcodes to parser (no support in engine yet)
+     - added support for amp_veltrack and amp_velcurve_N
+     - fine-tuned the default velocity curve
+     - added support for transpose
+     - fixed crash when using sw_down/up
+     - improved logic for sw_lokey/hikey/up/down/last
+     - added more v1 aliases to parser
+     - reduced memory usage for sfz data
+     - RT-safeness: avoid malloc in audio thread
+     - fixed a bug that could cause voice stealing to fail
+     - optimized sample lookup
+     - improved support for exclusive groups (group, off_by and
+       off_mode)
+     - added support for controller triggered regions (on_locc/on_hicc)
+     - added support for loop_mode=one_shot
+     - fixed playback of 16 bit wav files on big endian CPUs
+     - added support for Ogg Vorbis sample files
+     - use loop markers from sample file if loop_start and loop_end are
+       not set in sfz file
+     - implemeted filters. Filter types: lowpass, bandpass, bandreject
+       and highpass. 1, 2, 4 and 6 pole filters. Opcodes: fil_type,
+       cutoff, resonance, fil_veltrack, fil_keytrack, fil_keycenter,
+       cutoff_cc, cutoff_chanaft.
+     - bugfix: zero ampeg_sustain didn't work
+     - added support for velocity effect on amplifier envelope time
+       (ampeg_vel2attack, ampeg_vel2decay, ampeg_vel2sustain and
+       ampeg_vel2release)
+     - added support for EG hold (ampeg_hold)
+     - added support for sample offset (offset)
+     - use the newly introduced signal units model
+     - implemented opcodes lfoN_delay,
+       lfoN_freq, lfoN_pan, lfoN_cutoff, lfoN_resonance
+     - implemented opcodes ampeg_delay, ampeg_vel2delay
+       pitcheg_delay, pitcheg_start, pitcheg_attack, pitcheg_hold,
+       pitcheg_decay, pitcheg_sustain, pitcheg_release, pitcheg_vel2delay,
+       pitcheg_vel2attack, pitcheg_vel2hold, pitcheg_vel2decay,
+       pitcheg_vel2sustain, pitcheg_vel2release, pitcheg_depth
+     - implemented opcodes pitchlfo_delay, pitchlfo_freq,
+       pitchlfo_depth, fillfo_delay, fillfo_freq, fillfo_depth,
+       amplfo_delay, amplfo_freq, amplfo_depth
+     - implemented opcodes fileg_delay, fileg_start, fileg_attack,
+       fileg_hold, fileg_decay, fileg_sustain, fileg_release, fileg_vel2delay,
+       fileg_vel2attack, fileg_vel2hold, fileg_vel2decay, fileg_vel2sustain,
+       fileg_vel2release
+     - implemented opcode lfoN_wave
+     - implemented opcode pitchlfo_depthccN
+     - implemented opcodes lfoN_phase, lfoN_phase_onccX,
+       lfoN_pitch, lfoN_pitch_onccX
+     - implemented opcodes pitchlfo_fade,
+       fillfo_fade, amplfo_fade, lfoN_fade, lfoN_fade_onccX
+     - implemented opcodes fillfo_freqccN,
+       pitchlfo_freqccN, amplfo_freqccN, lfoN_freq_onccX
+     - implemented opcodes ampeg_delayccN, ampeg_startccN,
+       ampeg_attackccN, ampeg_holdccN, ampeg_decayccN, ampeg_sustainccN,
+       ampeg_releaseccN, egN_timeX_onccY, egN_levelX_onccY
+     - lfoN_* and egN_* opcodes defined in group sections
+       are now taken into account
+     - implemented curves
+     - implemented opcodes volume_onccN, volume_curveccN
+     - implemented opcode volume_smoothccN
+     - implemented opcodes fillfo_depthccN, amplfo_depthccN,
+       lfoN_volume, lfoN_volume_onccX, lfoN_volume_smoothccX,
+       lfoN_freq_smoothccX, lfoN_pitch_smoothccX, lfoN_pan_onccX,
+       lfoN_pan_smoothccX, lfoN_cutoff_onccX, lfoN_cutoff_smoothccX,
+       lfoN_resonance_onccX, lfoN_resonance_smoothccX, lfoN_delay_onccX
+     - implemented opcode end
+     - implemented opcodes egN_amplitude_onccX,
+       egN_volume, egN_volume_onccX, egN_cutoff, egN_cutoff_onccX,
+       egN_pitch, egN_pitch_onccX, egN_resonance, egN_resonance_onccX
+     - implemented opcodes xfin_lokey, xfin_hikey,
+       xfout_lokey, xfout_hikey, xf_keycurve, xfin_lovel, xfin_hivel,
+       xfout_lovel, xfout_hivel, xf_velcurve, xfin_loccN, xfin_hiccN,
+       xfout_loccN, xfout_hiccN, xf_cccurve
+     - implemented opcodes pan_onccN, pan_smoothccN,
+       pan_curveccN, egN_pan, egN_pan_curve, egN_pan_onccX,
+       egN_pan_curveccX, pitch_veltrack
+     - when failed to parse a sfz file
+       print the line number on which the error occurs
+     - use common pool of CC objects to minimize RAM usage
+     - implemented opcodes amplfo_delay_onccN,
+       amplfo_fade_onccN, fillfo_delay_onccN, fillfo_fade_onccN,
+       pitchlfo_delay_onccN, pitchlfo_fade_onccN
+     - implemented opcodes fileg_delay_onccN,
+       fileg_start_onccN, fileg_attack_onccN, fileg_hold_onccN,
+       fileg_decay_onccN, fileg_sustain_onccN, fileg_release_onccN,
+       fileg_depth_onccN, pitcheg_delay_onccN, pitcheg_start_onccN,
+       pitcheg_attack_onccN, pitcheg_hold_onccN, pitcheg_decay_onccN,
+       pitcheg_sustain_onccN, pitcheg_release_onccN, pitcheg_depth_onccN
+     - implemented automatic aliasing *ccN <-> *_onccN
+     - *lfo_freqccN wasn't working when the respective *lfo_freq
+       was not set or was set to zero
+     - lfoN_freq_onccX wasn't working when lfoN_freq
+       was not set or was set to zero
+     - implemented opcodes resonance_onccN, resonance_smoothccN,
+       resonance_curveccN, cutoff_smoothccN, cutoff_curveccN
+     - implemented opcodes fillfo_depthchanaft,
+       fillfo_freqchanaft, amplfo_depthchanaft, amplfo_freqchanaft,
+       pitchlfo_depthchanaft, pitchlfo_freqchanaft
+     - implemented opcodes pitch_onccN,
+       pitch_curveccN, pitch_smoothccN, pitch_stepccN
+     - implemented opcodes volume_stepccN, pan_stepccN,
+       cutoff_stepccN, resonance_stepccN, lfoN_freq_stepccX,
+       lfoN_volume_stepccX, lfoN_pitch_stepccX, lfoN_pan_stepccX,
+       lfoN_cutoff_stepccX, lfoN_resonance_stepccX
+     - implemented opcodes eq1_freq, eq2_freq, eq3_freq,
+       eq1_freqccN, eq2_freqccN, eq3_freqccN, eq1_bw, eq2_bw, eq3_bw,
+       eq1_bwccN, eq2_bwccN, eq3_bwccN, eq1_gain, eq2_gain, eq3_gain,
+       eq1_gainccN, eq2_gainccN, eq3_gainccN
+     - implemented opcodes delay, delay_onccN, delay_random,
+       delay_samples, delay_samples_onccN
+     - implemented opcodes egN_eq1gain, egN_eq2gain, egN_eq3gain,
+       egN_eq1gain_onccX, egN_eq2gain_onccX, egN_eq3gain_onccX, egN_eq1freq,
+       egN_eq2freq, egN_eq3freq, egN_eq1freq_onccX, egN_eq2freq_onccX,
+       egN_eq3freq_onccX, egN_eq1bw, egN_eq2bw, egN_eq3bw, egN_eq1bw_onccX,
+       egN_eq2bw_onccX, egN_eq3bw_onccX, lfoN_eq1gain, lfoN_eq2gain,
+       lfoN_eq3gain, lfoN_eq1gain_onccX, lfoN_eq2gain_onccX, lfoN_eq3gain_onccX,
+       lfoN_eq1gain_smoothccX, lfoN_eq2gain_smoothccX, lfoN_eq3gain_smoothccX,
+       lfoN_eq1gain_stepccX, lfoN_eq2gain_stepccX, lfoN_eq3gain_stepccX,
+       lfoN_eq1freq, lfoN_eq2freq, lfoN_eq3freq, lfoN_eq1freq_onccX,
+       lfoN_eq2freq_onccX, lfoN_eq3freq_onccX, lfoN_eq1freq_smoothccX,
+       lfoN_eq2freq_smoothccX, lfoN_eq3freq_smoothccX, lfoN_eq1freq_stepccX,
+       lfoN_eq2freq_stepccX, lfoN_eq3freq_stepccX, lfoN_eq1bw, lfoN_eq2bw,
+       lfoN_eq3bw, lfoN_eq1bw_onccX, lfoN_eq2bw_onccX, lfoN_eq3bw_onccX,
+       lfoN_eq1bw_smoothccX, lfoN_eq2bw_smoothccX, lfoN_eq3bw_smoothccX,
+       lfoN_eq1bw_stepccX, lfoN_eq2bw_stepccX, lfoN_eq3bw_stepccX
+     - implemented opcodes eq1_vel2freq, eq2_vel2freq,
+       eq3_vel2freq, eq1_vel2gain, eq2_vel2gain, eq3_vel2gain
+     - sfz parser: allow double spaces in sample filenames
+     - sfz parser: allow absolute paths for sample filenames
+     - use linear decay and release for filter and pitch EG
+     - bugfix: only the first amp_veltrack definition in a file was
+       used
+     - bugfix: looping was disabled if loop_start was set to 0
+     - allow regions with end=-1 to turn off other regions using the
+       group and off_by opcodes (#168)
+     - made end=0 play the whole sample
+     - fixed support for lochan and hichan opcodes (#155)
+     - fixed crash when using lochan/hichan opcodes (#187)
+     - sfz parser: allow -200 to 200 for pan_oncc opcode (#182)
+     - added FLAC support (#191)
+     - sfz parser bugfix: lines starting with whitespace were ignored
+     - added amplitude opcode
+     - added support for "#include" instruction
+       (modified patch which was originally posted by Sergey on LS mailing list)
+     - bugfix: generation of velocity curves etc should not be done
+       after each "#include", only after the main file is parsed
+     - bugfix: line numbers in error messages were wrong after "#include"
+     - added support for float and 32 bit sample files
+   * SoundFont format engine:
+     - Initial implementation (not usable yet)
+     - RT-safeness: avoid malloc in audio thread
+     - fixed a bug that could cause voice stealing to fail
+     - fine-tuned amplitude EG (by switching from gig to sfz EG)
+     - initial implementation of Vibrato LFO and Modulation LFO
+     - initial implementation of cutoff filter
+     - use linear decay and release for filter and pitch EG
+   * Host plugins (VST, AU, LV2, DSSI):
+     - AU bugfix: failed to destroy its audio/MIDI devices
+     - Listen to all interfaces on Mac OS X (INADDR_ANY)
+     - VST bugfix: If the host called resume() before and after
+       changing sample rate or block size, the number of channels was
+       incorrectly set to two. This caused silence in Cubase 5.
+     - save engine type (gig, sfz or sf2) in plugin state
+     - VST: when opening Fantasia, look for both 32 and 64 bit Java on
+bit Windows
+     - AU: changed number of output channels from one stereo to 16
+       stereo
+     - VST: made it possible to build the VST plugin for Mac
+     - AU: link AU plugin dynamically if --disable-shared isn't
+       specified
+     - LV2 "state" extension support (patch by David Robillard)
+     - VST bugfix: instrument loading hang and crashed the host when
+       the plugin was loaded a second time (#174)
+     - plugin bugfix: instrument loading hang when the plugin was
+       loaded a second time (this time it's for Linux and Mac, previous
+       similar fix was for Windows)
+     - thread safety fixes for the instrument loading thread
+     - LV2: use the new lv2 package if present
+     - VST: try to open Fantasia automatically on Linux and Mac too (on
+       Linux, the Fantasia jar should be placed in <prefix>/share/java)
+     - VST: fixed crashes on Linux Ardour and EnergyXT
+     - DSSI bugfix: it wasn't possible to change engine type. The MIDI
+       port and audio channel routing for DSSI plugins are now visible.
+     - LV2: use urid and atom extensions instead of deprecated uri-map
+       and event
+     - LV2: lv2 package 1.0 is now required to build the LV2 plugin
+     - LV2: changed number of output channels to 16 stereo, just like
+       the VST and AU plugins
+     - LV2: fixed save/restore of SFZ state (patch by David Robillard)
+     - LV2: made LV2 plugin buildable on Windows and Mac
+     - VST: implemented retrieval and switching of programs using the
+       sampler's internal MIDI instrument mapping system
+   * Instrument editor interface:
+     - Changed instrument editor plugin interface, providing additional
+       informations like the EngineChannel for which the instrument editor was
+       spawned for. This allows the instrument editors to interact more actively
+       with the sampler.
+   * MIDI driver:
+     - ALSA MIDI driver supports now "NAME" device parameter, for overriding
+       the ALSA sequencer client name
+     - removed limit of maximum amount of MIDI ports per MIDI device, since
+       there is no reason for this limit
+     - MME: fixed memory handling bug found with cppcheck
+     - MME: removed compiler warning
+     - CoreMIDI: implemented driver specific port parameter "CORE_MIDI_BINDINGS",
+       which allows to retrieve the list of CoreMIDI clients / ports and to connect
+       to them a la JACK, via the usual sampler APIs
+     - CoreMIDI: added driver specific port parameter "AUTO_BIND", if enabled
+       the driver will automatically connect to other CoreMIDI clients' ports
+       (e.g. external MIDI devices being attached to the Mac)
+     - added support for MIDI note on velocity filter
+     - CoreMIDI: fixed memory deallocation error
+     - Fixed variable underflow in VirtualMidiDevice, which caused graphical
+       virtual keyboards in frontends / instrument editors being stuck.
+     - Bugfix in VirtualMidiDevice: process note on with velocity 0 as note off.
+     - Implemented missing handling of MIDI "running status".
+     - CoreMIDI fix: a MIDIPacket can contain more than one event per packet.
+     - MME bugfix: driver wasn't closed properly
+     - CoreMIDI: automatically connect to all input sources by default (driver
+       parameter "AUTO_BIND").
+     - CoreMIDI: fixed auto bind feature to CoreMIDI ports that go online
+     - CoreMIDI: fixed minor memory leak
+   * audio driver:
+     - ASIO driver fixes for newer gcc versions (fix from PortAudio)
+     - JACK audio: react on sample rate changes.
+     - JACK audio: react on buffer size changes.
+     - JACK audio: jack_port_get_buffer() was cached and called outside
+       RT context.
+     - ASIO driver: removed compiler warnings
+     - CoreAudio: fixed minor error handling bug
+     - ASIO driver: be more verbose when no ASIO card could be found (fixes #203)
+     - JACK audio: return the JACK server's current sample rate as default value
+       for audio device parameter "SAMPLERATE" (fixes #166).
+   * LSCP server:
+     - added support for sending MIDI CC messages via LSCP command
+       "SEND CHANNEL MIDI_DATA CC <sampler-chan> <ctrl> <val>"
+     - added LSCP command "GET AVAILABLE_EFFECTS"
+     - added LSCP command "LIST AVAILABLE_EFFECTS"
+     - added LSCP command "GET EFFECT INFO <effect-index>"
+     - added LSCP command "CREATE EFFECT_INSTANCE <effect-index>"
+     - added LSCP command
+       "CREATE EFFECT_INSTANCE <effect-system> <module> <effect-name>"
+     - added LSCP command "DESTROY EFFECT_INSTANCE <effect-instance>"
+     - added LSCP command "GET EFFECT_INSTANCES"
+     - added LSCP command "LIST EFFECT_INSTANCES"
+     - added LSCP command "GET EFFECT_INSTANCE INFO <effect-instance>"
+     - added LSCP command
+       "GET EFFECT_INSTANCE_INPUT_CONTROL INFO <effect-instance> <input-control>"
+     - added LSCP command "SET EFFECT_INSTANCE_INPUT_CONTROL VALUE
+       <effect-instance> <input-control> <value>"
+     - added LSCP command "GET SEND_EFFECT_CHAINS <audio-device>"
+     - added LSCP command "LIST SEND_EFFECT_CHAINS <audio-device>"
+     - added LSCP command "ADD SEND_EFFECT_CHAIN <audio-device>"
+     - added LSCP command
+       "REMOVE SEND_EFFECT_CHAIN <audio-device> <effect-chain>"
+     - added LSCP command
+       "GET SEND_EFFECT_CHAIN INFO <audio-device> <effect-chain>"
+     - added LSCP command "APPEND SEND_EFFECT_CHAIN EFFECT <audio-device>
+       <effect-chain> <effect-instance>"
+     - added LSCP command "INSERT SEND_EFFECT_CHAIN EFFECT <audio-device>
+       <effect-chain> <effect-chain-pos> <effect-instance>"
+     - added LSCP command "REMOVE SEND_EFFECT_CHAIN EFFECT <audio-device>
+       <effect-chain> <chain-pos>"
+     - added LSCP command "SET FX_SEND EFFECT <sampler_channel>
+       <fx_send_id> <effect_chain> <chain_pos>"
+     - added LSCP command "REMOVE FX_SEND EFFECT <sampler_channel> <fx_send_id>"
+     - added LSCP commands "SUBSCRIBE EFFECT_INSTANCE_COUNT",
+       "SUBSCRIBE EFFECT_INSTANCE_INFO", "SUBSCRIBE SEND_EFFECT_CHAIN_COUNT",
+       "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"
+     - provide comprehensive error messages on LSCP syntax errors
+       (suggesting expected next non-terminal symbols)
+     - Fixed client connection not being closed after network errors.
+   * LSCP shell:
+     - Added support for auto correction of obvious and trivial syntax mistakes.
+     - Added support for auto completion by tab key.
+     - Show currently available auto completion while typing.
+     - Added support for browsing command history with up / down keys.
+     - Show all possible next symbols immediately right to the current command
+       line while typing (no double tab required for this feature, as it would
+       be the case in other shells).
+     - Added support for moving cursor left/right with arrow keys.
+     - Added support for built-in LSCP reference documentation, which will
+       automatically show the relevant LSCP reference section on screen as soon
+       as one specific LSCP command was detected while typing on the command
+       line.
+   * Real-time instrument scripts:
+     - Implemented built-in script array variable %CC.
+     - Implemented built-in script int variable $CC_NUM.
+     - Implemented built-in script int variable $EVENT_NOTE.
+     - Implemented built-in script int variable $EVENT_VELOCITY.
+     - Implemented built-in script constant variable $VCC_MONO_AT.
+     - Implemented built-in script constant variable $VCC_PITCH_BEND.
+     - Implemented execution of script event handler "init".
+     - Implemented execution of script event handler "controller".
+     - Implemented execution of script event handler "note".
+     - Implemented execution of script event handler "release".
+     - Implemented built-in script function "play_note()" (only two of the
+       max. four function arguments are currently implemented yet though).
+     - Implemented built-in script int variable $EVENT_ID.
+     - Implemented built-in script function "ignore_event()"
+     - Implemented built-in script function "ignore_controller()" (may have one
+       or no argument).
+     - Implemented built-in script function "set_controller()".
+     - Added extended script VM for the Gigasampler/GigaStudio format sampler
+       engine, which extends the general instrument script VM with Giga format
+       specific variables and functions.
+     - Giga format scripts: added built-in script int constant variables
+       $GIG_DIM_CHANNEL, $GIG_DIM_LAYER, $GIG_DIM_VELOCITY, $GIG_DIM_AFTERTOUCH,
+       $GIG_DIM_RELEASE, $GIG_DIM_KEYBOARD, $GIG_DIM_ROUNDROBIN, $GIG_DIM_RANDOM,
+       $GIG_DIM_SMARTMIDI, $GIG_DIM_ROUNDROBINKEY, $GIG_DIM_MODWHEEL,
+       $GIG_DIM_BREATH, $GIG_DIM_FOOT, $GIG_DIM_PORTAMENTOTIME, $GIG_DIM_EFFECT1,
+       $GIG_DIM_EFFECT2, $GIG_DIM_GENPURPOSE1, $GIG_DIM_GENPURPOSE2,
+       $GIG_DIM_GENPURPOSE3, $GIG_DIM_GENPURPOSE4, $GIG_DIM_SUSTAIN,
+       $GIG_DIM_PORTAMENTO, $GIG_DIM_SOSTENUTO, $GIG_DIM_SOFT,
+       $GIG_DIM_GENPURPOSE5, $GIG_DIM_GENPURPOSE6, $GIG_DIM_GENPURPOSE7,
+       $GIG_DIM_GENPURPOSE8, $GIG_DIM_EFFECT1DEPTH, $GIG_DIM_EFFECT2DEPTH,
+       $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.
+     - Giga format scripts: Implemented built-in script function
+       "gig_set_dim_zone(event_id, dimension, zone)".
+     - Implemented built-in script int array variable %KEY_DOWN.
+     - Implemented built-in script function "abs()".
+     - Implemented built-in script function "random()".
+     - Implemented built-in script function "num_elements()".
+     - Implemented built-in script function "note_off()".
+     - Implemented built-in script function "set_event_mark()".
+     - Implemented built-in script function "delete_event_mark()".
+     - Implemented built-in script function "by_marks()".
+     - Added built-in script int const variables $MARK_1 to $MARK_28.
+     - Built-in script functions "ignore_event()", "note_off()" and
+       "gig_set_dim_zone()" now also accept an array of event IDs as argument
+       (i.e. return value of new script function "by_marks()").
+     - Pass/preserve polyphonic variable data from respective "note" event
+       handler to "release" event handler.
+     - Fixed crash when using built-in script function "by_marks()".
+   * Bug fixes:
+     - Fixed crash which may occur when MIDI key + transpose is out of range
+     - minor valgrind fixes
+     - fixed crash which occurred when changing an already deployed sampler
+       channel to a different engine type
+     - fixed crash when deleting a sampler channel or changing engine
+       type while an instrument load was in progress
+     - bugfix: playing a note while changing the instrument could cause
+       a crash, or give "Handing back unknown region" error messages
+     - bugfix: calling SET VOICES (which Fantasia does on start and
+       refresh) could cause instruments to be unloaded
+     - Mac OS X: fixed name collision of enum in EffectControl and
+       wrong name of destructor in AudioOutputDeviceCoreAudio.cpp
+     - Mac OS X: fixed hanging threads
+     - Windows: disabled the previous thread fix on non-Mac systems, as
+       it caused hanging threads on Windows
+     - Fixed possible crashes due to corrupted MIDI/audio device list
+       after MIDI/audio device creation failure
+     - When creating MIDI instrument map entries with "PERSISTENT" type, the
+       instruments were uselessly precached with zero samples, however it still
+       took the full preloading time and on 1st program change the respective
+       instrument was completely reloaded again.
+     - fixed handling of rapid bank select and program change messages
+       sent to the same sampler channel (patch from the Open Octave
+       project, slightly adjusted)
+     - fixed crash when trying to create an effect instance with controls
+       which min and/or max values depend on the sample rate
+     - fixed bug #162
+     - bugfix: LADSPA_PATH was not evaluated correctly when containing
+       multiple paths (#165)
+     - thread safety fixes for the instrument loading thread
+     - bugfix: instrument loading crashed for sfz and sf2 in Ardour
+       (#176)
+     - more thread safety fixes for the instrument loading thread
+     - sfz/sf2 engine: fixed crash when using small audio fragment size
+     - Mac OS X: fixed crash when unloading plugin on 10.7 and later
+     - Mac OS X: fixed process hang when unloading 32-bit plugin (bug
+       introduced in previous fix)
+     - fixed crash when a channel received a program change while
+       playing a note in a key group
+     - fixed erroneous error message piping in VoiceBase.h
+       (labelled "Disk stream not available in time")
+     - Update effects on sample rate & period size changes (to avoid
+       crashes and noise on such transitions).
+     - ignore missing LADSPA paths without ignoring valid LADSPA paths
+       (fixes #208)
+     - Fixed bug in LSCP grammar definition which caused a statement like
+       "GET SERVER INFOasdf\n" to be accepted as valid statement (was so far
+       practically irrelevant, however it caused problems with the new LSCP
+       shell's auto completion feature).
+     - Fixed MIDI program change messages being ignored if quickly executed
+       after each other (fixes #231).
+ Version 1.0.0 (31 July 2009)
+   * packaging changes:
+     - autoconf bugfix: the PKG_CONFIG variable wasn't initialized properly,
+       causing e.g. the libgig test to fail when
+       "./configure --disable-jack-driver" was used
+       (patch by Alexis Ballier)
+     - fixed compilation with gcc 4.3
+     - fixes for building on OS X (thanks to Ebrahim Mayat for testing)
+     - fixed configure so it detects x86_64 (#107)
+     - fixes for building with newer MinGW versions
+     - fix for building with bison 2.4 (#111)
+     - fixed building with libgig installed in a non-standard directory
+     - minor fix in configure for mmsystem.h detection on MinGW
+     - Windows: look for editor plugins and Fantasia using base
+       directory of liblinuxsampler dll (look in the same directory and one
+       directory above)
+     - configure script fix: removed unconditional use of SSE
+     - fixed building with sqlite installed in a non-standard directory
+     - when cross-compiling, don't try to create instruments.db
+     - fix for new mingw-w64 version, which has usleep
+   * general changes:
+     - bugfix: on some POSIX systems instrument editor plugins refused to
+       load as we used a non-portable Linux specific struct field
+       (fixes bug #70, patch by Ronald Baljeu)
+     - fixed endless loop which occured when loading an instrument editor
+       plugin DLL on Windows systems failed
+     - fixed memory leaks that occurred when liblinuxsampler was unloaded
+     - optimized the SynchronizedConfig class so it doesn't wait
+       unnecessarily long after an update
+     - added support for notifying instrument editors on note-on / note-off
+       events (e.g. to highlight the pressed keys on the virtual keyboard
+       of gigedit)
+     - added support for triggering notes by instrument editors (see above)
+     - be verbose on DLL load errors (on Linux)
+     - fixed di-harmonic triangle LFO implementation (this LFO implementation
+       is only used by very few systems, most pick the int math
+       implementation, which is usually faster)
+     - fixes for audio drivers with varying buffer sizes
+     - experimental support for running LinuxSampler as a DSSI, LV2 and
+       VST plugin
+     - notification events for stream/voice count statistics are now sent
+       only when there are actual changes
+     - added memory ordering constraints to improve stability on
+       multi-core and multi-cpu systems
+     - maximum voices and disk streams can now be altered at runtime
+     - fixed CPU feature detection on x86_64 (maybe fixes #108)
+     - automatic stacktrace mechanism is now turned off by default and can
+       be switched on by command line option "--stacktrace" (the automatic
+       stacktrace mechanism seems to be broken on most systems at the moment)
+     - C++ API method InstrumentManager::LaunchInstrumentEditor() now returns
+       a pointer to the launched InstrumentEditor object
+     - added optional 3rd party user data parameter for following
+       liblinuxsampler C++ API methods: InstrumentEditor::Main(),
+       InstrumentEditor::Launch(),
+       InstrumentManager::LaunchInstrumentEditor()
+     - theoretical fix: made SynchronizedConfig follow C++0x memory
+       model more strictly
+     - fixes for using large audio device buffers
+     - Windows: add the installation directory to the DLL search path
+       when loading an editor plugin (solves problems with VST and
+       gigedit on systems with other GTK versions installed)
+     - updated linuxsampler man page
+   * audio driver:
+     - removed the nonsense audio channel constraint (which was hard coded to
+       max. 100 audio channels) for most audio drivers
+     - JACK audio driver did not offer a device parameter "SAMPLERATE" as
+       opposed to the LSCP specs
+     - bugfix: the SAMPLERATE parameter of some drivers (e.g. JACK)
+       reflected the wrong value
+     - fixed a memory management bug in ASIO driver
+     - Makefile fix: JACK_CFLAGS wasn't used
+     - JACK: use jack_client_open instead of the deprecated
+       jack_client_new
+     - added (experimental) CoreAudio driver
+     - applied old fixes to the ASIO driver that were included in the
+       previous binary release but accidentally never committed to CVS
+       (fixes #117)
+     - fixes for ASIO on mingw-w64 (iasio wrapper is not needed on
+       win64)
+     - VST: added support for sample rate and buffer size changes
+     - VST: close editor (Fantasia) when the VST is removed
+     - VST: avoid opening Fantasia more than once for each VST instance
+     - VST: export main function as "main" on Linux too (fix for
+       energyXT)
+     - VST: changed number of output channels from one stereo to 16
+       stereo
+     - added channel routing, fxsends and midi maps to the settings
+       stored in the plugin state
+     - performance optimization of AudioChannel::MixTo() and
+       AudioChannel::CopyTo() methods using GCC vector exensions
+       (if available)
+     - ASIO fixes: avoid initializing the device twice, avoid throwing
+       exception when getting parameters from a disconnected device
+   * MIDI driver:
+     - added JACK MIDI driver
+     - dispatch bank select as ordinary CC as well, the user might seriously
+       want to (mis)use it for some purpose ("fixed" in all current MIDI
+       input drivers: ALSA, CoreMIDI, JACK, MidiShare, MME)
+     - bugfix: pitch bend wasn't working with JackMidi, VST, LV2, MME,
+       CoreMidi or AU
+     - fixed mingw-w64 compilation error in MME driver
+     - made program change handling in MIDI thread real-time safe by
+       moving the logic to a non-RT thread
+     - fixed minor memory leak in ALSA driver
+   * instruments database:
+     - avoid time consuming samples scanning when adding instruments
+       to the instruments database
+     - added support for handling lost files in the instruments database
+     - Implemented option for adding instruments in separate directories
+       in the instruments database
+       (patch by Chris Cherrett & Andrew Williams, a bit adjusted)
+     - work-around for missing fnmatch function on Windows to make
+       instrument database compilable
+     - added instrument database support on Windows
+       works with both standalone mode and VST plugin.
+       the instruments DB file is located in
+       %USERPROFILE%\.linuxsampler\instruments.db which allows different
+       databases for each windows user
+       if no DB is present it automatically creates the .linuxsampler subdir
+       and then creates an empty DB
+     - fixed recursive import, which was broken on Windows
+   * Gigasampler format engine:
+     - fixed a memory leak that could happen when a channel was deleted
+       while notes were playing
+     - made it possible to load an instrument even if the audio thread
+       isn't running
+     - added partial support for the "Controller Triggered" MIDI rule,
+       enough for piano gigs with pedal noise samples
+     - minor fix: only mark FX sends as being modified if really the
+       respective FX send MIDI controller was used
+     - added support for GM global device volume SysEx message
+       (can be selected at compile time to either apply globally to the
+       whole sampler [default] or only to the sampler channels that are
+       connected to the respective MIDI input port the SysEx message arrived
+       on)
+     - bugfix: notes triggered at position 0 in the audio buffer were
+       sometimes wrongly killed in the same buffer, causing no sound to
+       be played
+     - added support for chromatic / drumkit mode Roland GS Sysex message
+       which is usally used to switch a part between chromatic sounds and
+       drumkit sounds (as opposed to their common default setting of MIDI
+       part 10 being a drumkit part and all other ones chromatic parts), in
+       LS however one can switch between the first 16 MIDI instrument maps
+       defined for the sampler
+     - made it possible to create multiple sample channels even if the
+       audio thread isn't running
+     - fixed crash when removing channel with active voices (#116)
+     - bugfix: on sample reference changes (instrument editor), only
+       un-cache the respective sample if it's really not used by any
+       sampler engine anymore
+     - re-cache samples in case they were changed by an instrument editor,
+       e.g. when a sample was added while playing (#82)
+     - fixed hanging notes which occured when note-off event had the exact
+       same time stamp as the voice's note-on event and occured both in the
+       same audio fragment cycle (fixes bug #112)
+     - added support for the "fine tune" and "pitch bend range"
+       instrument-level gig parameters
+     - fixed minor artifacts in pitch bend handling
+     - added support for GS Reset SysEx message
+     - allow gig files to use unlimited downward pitch shifting
+     - added a limit check for upward pitch shifting
+     - bugfix: sometimes, when playing a note twice fast, the second
+       note was silent
+     - fixed crash happening when a pitch bend event arrived at the
+       same time a new instrument was loading
+   * LSCP server:
+     - added new LSCP event "CHANNEL_MIDI" which can be used by frontends to
+       react on MIDI data arriving on certain sampler channels (so far only
+       Note-On and Note-Off events are sent via this LSCP event)
+     - added new LSCP event "DEVICE_MIDI" which can be used by frontends to
+       react on MIDI data arriving on certain MIDI input devices (so far only
+       Note-On and Note-Off events are sent via this LSCP event)
+     - added new LSCP commands: FIND LOST DB_INSTRUMENT_FILES and
+       SET DB_INSTRUMENT FILE_PATH
+     - added new LSCP command: SEND CHANNEL MIDI_DATA which can be used by
+       frontends to send MIDI messages to specific sampler channel
+     - added two additional fields to GET FILE INSTRUMENT INFO command -
+       KEY_BINDINGS and KEYSWITCH_BINDINGS
+     - bugfix: the bank number provided by MIDI_INSTRUMENT_INFO notifications
+       was incorrect
+     - Optimized the retrieval of the MIDI instrument mappings
+     - added new LSCP command "SET VOICES" to globally alter the maximum
+       amount of voices, added new LSCP event "GLOBAL_INFO:VOICES" which will
+       be triggered respectively
+     - added new LSCP command "SET STREAMS" to globally alter the maximum
+       amount of disk streams, added new LSCP event "GLOBAL_INFO:STREAMS"
+       which will be triggered respectively
+     - bugfix: retry if "select" returns EINTR (this fixes a crash when
+       a gigedit file dialog is opened)
+     - close all connections when LSCPServer is deleted
+     - hard close of all sockets on exit
+     - bugfix: SET CHANNEL MIDI_INPUT_TYPE didn't work with the MME
+       driver
+   * Bug fixes:
+     - fixed a crash which occurs when removing a sampler channel waiting
+       to start instrument loading after another channel
+     - fixed a crash which occurs when removing a sampler channel with
+       instrument loading in progress (bug #113)
+     - fixed termination caused by uncaught exception when adding MIDI
+       instrument with PERSISTENT load mode
+     - fixed possible iterator invalidations when resetting the sampler
+     - fixed memory leaks when issuing the following LSCP commands:
+       GET AUDIO_OUTPUT_DRIVER INFO
+       GET AUDIO_OUTPUT_DRIVER_PARAMETER INFO
+       GET MIDI_INPUT_DRIVER INFO
+       GET MIDI_INPUT_DRIVER_PARAMETER INFO
+     - fixed possible compilation error when sqlite is not present
+     - fixed orphaned pointers when setting maximum voices limit (bug #118)
+     - fixed crash when changing the audio output device of a sampler
+       channel with loaded instrument and start playing notes
+     - fixed endless loop in Engine::SuspendAll() (bug #120)
+     - fixed a low-level atomic load function that was broken on 64-bit
+       PowerPC, which probably could cause crashes on that platform
+     - fixed a memory management error which could cause a crash when a
+       plugin was unloaded
+     - bugfix: two private structs had the same name, which could cause
+       problems if the linker chose the wrong constructor
+     - fixed low-level ConditionServer usage bug that caused lockups on
+       Windows
+ Version 0.5.1 (6 December 2007)
+   * packaging changes:
+     - added autoconf checks for pthread library
+     - added autoconf check for pthread bug found on certain NPTL-enabled
+       glibc versions (see Gentoo bug report #194076)
+     - added autoconf checks for MS Windows
+   * general changes:
+     - bugfix: the thread used by an editor plugin didn't die when the
+       editor closed
+     - bugfix: Ringbuffer.h: fill_write_space_with_null() did not zero
+       out all the space. operator--() did not apply size_mask after
+       decrementing the read_ptr. DEFAULT_WRAP_ELEMENTS set to 0 in
+       order to avoid problems with the _NonVolatileReader functions.
+     - bugfix: Stream.h: added a missing divide by BytesPerSample in
+       GetWriteSpace(). Since this function is currently only used in
+       the stream's qsort() compare function, it didn't trigger any
+       bugs.
+     - Resampler.h, Synthesizer.h: cubic interpolation now works in
+bit mode too. Faster method to read 24bit words on little
+       endian machines (x86): replaced 3 byte reads + shifts with a 1
+       unaligned 32bit read and shift
+     - experimental support for MS Windows (MIDI input via MME, AUDIO
+       output via ASIO)
+     - made handling of SIGINT signal (Ctrl-C) a bit more robust
+     - support for monitoring the total number of active disk streams
+       (new LSCP commands: GET TOTAL_STREAM_COUNT,
+       SUBSCRIBE TOTAL_STREAM_COUNT, UNSUBSCRIBE TOTAL_STREAM_COUNT)
+   * AUDIO driver:
+     - added Windows ASIO low latency audio driver
+   * MIDI driver:
+     - added MME Windows MIDI driver
+   * LSCP server:
+     - added support for Windows style path / filenames, however with
+       forward slash path separators instead of backslash
+       (i.e. "C:/foo/bar.gig")
+     - allow naughty liblscp to send non-string device parameters within
+       apostrophes as well
+     - added new LSCP commands: "GET FILE INSTRUMENTS <file>",
+       "LIST FILE INSTRUMENTS <file>" and
+       "GET FILE INSTRUMENT INFO <file> <index>" for retrieving informations
+       about an arbitrary instrument file on the system where the sampler is
+       running on
+ Version 0.5.0 (15 October 2007)
+   * packaging changes:
+     - config.h is not going to be installed along with liblinuxsampler's
+       API header files anymore
+     - only the API relevant header (and source) files will be exported to
+       the Doxygen API documentation (explicitly listed in Doxyfile.in)
+     - added completely new XCode project files for Mac OSX which is now
+       capable to execute our autoconf environment, thus no need anymore
+       to maintain the compile time configuration file (osx/version.h) for
+       OSX manually (patch by Toshi Nagata)
+     - fixed buggy boolean --enable-foo / --disable-foo configure script
+       parameters
+     - global.h now only covers global definitions that are needed for the
+       C++ API header files, all implementation internal global definitions
+       are now in global_private.h
+     - atomic.h is not exposed to the C++ API anymore
+     - no need to include config.h anymore for using LS's API header files
+     - fixed warnings in API doc generation
+   * general changes:
+     - replaced the old, confusing MIDI program change mechanism by a
+       flexible MIDI instrument mapper which allows to map arbitrary
+       (MIDI bank, MIDI program) pairs with arbitrary
+       (engine type, instrument file, file index) triplets which will be
+       loaded on the respective channel when such MIDI program change
+       messages arrive, beside that, each entry allows to define a life-time
+       strategy for the instrument, so the user can define whether the
+       instrument should i.e. be permanently loaded (to be able to switch
+       quickly among sounds) or i.e. loaded just on demand when the
+       respective program change arrives (to safe RAM space), as well as a
+       global volume factor for each entry, so the user can adjust the volume
+       dynamic of his mapped instrument collection without having to modify
+       the instrument files, also one can manage arbitrary amount of such
+       MIDI instrument maps and assign each sampler channel individually
+       a certain map, so that i.e. separation of normal instruments and
+       drumkits is possible
+     - new notification events for tracking changes to audio/MIDI devices,
+       MIDI instrument maps, MIDI instruments, FX sends, global volume.
+     - sampler was limited to load max. 200 instruments in the background
+       due to a constant size RingBuffer FIFO which is now replaced by a
+       dynamic (unlimited) size std::list FIFO
+     - added FX sends, these allow to route audio signals to arbitrary audio
+       output channels for being processed by external effect processors
+       (i.e. jack-rack), the send levels are controllable via arbitrary MIDI
+       controllers
+     - global (sampler wide) volume can now be controlled at runtime
+     - Implemented new, improved notification system
+     - fixed compilation errors regarding OSX
+       (patch by Toshi Nagata)
+     - implemented instruments database
+     - added support for escape sequences to the instruments database
+     - added highly experimental support for on-the-fly instrument editing
+       within the sampler's process (by using instrument editor plugins),
+       you'll notice the new "Registered instrument editors:" message on
+       startup, added a new LSCP command:
+       "EDIT CHANNEL INSTRUMENT <sampler-channel>"
+       to spawn a matching instrument editor for the instrument on the
+       given sampler channel, the plugin path can be overridden at compile
+       time with ./configure --enable-plugin-dir=/some/dir
+     - added experimental code for synchronizing instrument editors hosted
+       in the sampler's process to safely edit instruments while playing
+       without a crash (hopefully) by either suspending single regions
+       wherever possible or if unavoidable whole engine(s)
+     - fixed several issues in fundamental "Thread" class: set scheduling
+       policy and priority on thread level, set a minimum stack size for
+       thread (TODO: a reasonable value yet to be tested), bugfix: non-RT
+       threads simply inherited properties of starting thread instead of
+       setting their own policy and priority
+     - minor fix in our automatic stack trace mechanism on crashes, the
+       main process did not wait for the stack trace process to finish
+       its output
+     - fixed some minor memory leaks
+     - reenabled assembly features support, at the moment only for
+       enabling a fast denormal FPU mode (x86 platforms supporting SSE2)
+     - minor assembly fix in x86 features detection (don't use the PIC
+       register, to avoid relocations in the text segment at runtime)
+     - POSIX callback functions of Thread.h are hidden
+   * MIDI driver:
+     - dispatch bank select (MSB and LSB) messages
+   * audio driver:
+     - the ALSA audio output driver parameters now reflect the correct
+       parameter value ranges for the respective selected sound card
+       (patch by Till Wimmer, a bit fixed and extended)
+   * Gigasampler format engine:
+     - if a filter is used and EG2 finishes before EG1, let the voice
+       die when EG2 has finished (this fixes a problem with clicks and
+       voice starvation for some gigs)
+     - playback is no longer disabled during instrument loading
+     - all notes playing on a channel that changes its instrument keep
+       playing with the old instrument until they get a note off
+       command
+     - EG fix: a release value of zero could cause noises or crash
+     - handle MIDI coarse tuning messages (MIDI RPN #0 MSB #2 LSB)
+     - EG fine tuning: when attack is zero the EG starts at a level
+       above max sustain level, which means that there is a decay phase
+       even if sustain is 100%
+     - more EG fixes: the level could sometimes go below zero and cause
+       noises or crashes
+     - minor fix of EGDecay (patch by Toshi Nagata)
+     - fixed compiler error when --enable-override-filter-type was
+       supplied to the configure script (fixes #46)
+     - disk thread: queue sizes are now proportional to CONFIG_MAX_STREAMS
+       instead of a fix value
+     - behavior fix: on MIDI CC# 65 (portamento on / off), 126 (mono mode),
+(solo mode) only kill voices if the respective mode really
+       changed
+   * LSCP server:
+     - fixed compile time error for old Bison versions
+       (i.e. v1.28 found on MacOS 10.4, patch by Toshi Nagata)
+     - parser now supports extended ASCII character set
+       (up to ASCII code 255, i.e. includes now umlauts and accents)
+     - filename arguments in LSCP commands now allow to use escape
+       sequences, that is directly literal as one of: \', \", \\, \n, \r,
+       \f, \t, \v, or as octal ASCII code value like \132, or as hex ASCII
+       code value like \xf2) (fixes bug #24)
+     - the following LSCP commands now also support escape sequences for at
+       least one of their text-based parameters (i.e. name, description):
+       "ADD MIDI_INSTRUMENT_MAP", "MAP MIDI_INSTRUMENT",
+       "SET MIDI_INSTRUMENT_MAP NAME", "SET FX_SEND NAME", "CREATE FX_SEND",
+       "SET DB_INSTRUMENT_DIRECTORY NAME",
+       "SET DB_INSTRUMENT_DIRECTORY DESCRIPTION", "SET DB_INSTRUMENT NAME",
+       "SET DB_INSTRUMENT DESCRIPTION", "FIND DB_INSTRUMENTS",
+       "FIND DB_INSTRUMENT_DIRECTORIES"
+     - returns verbose syntax errors (line and column where syntax error
+       occured, the unexpected character and the actually expected, possible
+       character(s), the latter only if less than 5 possibilities)
+     - made sure that LSCP syntax is not affected by gigedit locale
+       settings
+     - bugfix regarding strings parameter lists: all comma separated lists
+       of strings were treated as being one string containing commas
+       (fixes #57)
+   * Bug fixes:
+     - fixed crash occurring on certain LSCP scripts (Bug 39)
+     - another thread safety fix for lscp "load engine" and "set
+       channel audio output device"
+     - fixed a crash which occurs when reassigning the same engine
+       on a sampler channel with connected MIDI device
+     - fixed a crash which occurs when changing the number of ports of a MIDI
+       device connected to a sampler channel to number less then or equal
+       to the index of the port to which the sampler channel is connected.
+     - The previous bindings were not been disconnected when altering
+       the ALSA_SEQ_BINDINGS parameter. Introduced a NONE keyword for
+       unsubscribing from all bindings (e.g. ALSA_SEQ_BINDINGS=NONE).
+     - The active stream/voice count statistic was incorrect.
+     - notification events were not been sent for some sampler
+       channel changes
+     - added default min and max values to restrict the number of allowed
+       audio output channels and MIDI input ports
+     - the connection to the PCM interface is now closed when destroying
+       an audio output device
+     - files with slash in their path or filename could not be loaded
+   * test cases:
+     - updated and fixed (haven't been touched in a while)
+ Version 0.4.0 (24 November 2006)
+   * packaging changes:
+     - changed deprecated copyright attribute to license; added ldconfig
+       to post-(un)install steps; added devel package for liblinuxsampler;
+       to linuxsampler.spec (RPM)
+     - install necessary development header files for allowing 3rd party
+       applications to link against liblinuxsampler
+     - liblinuxsampler's API documentation can be generated with 'make docs'
+       (Doxygen required)
+     - added benchmark to automatically detect the best triangle LFO
+       implementation (currently either an integer math solution or a
+       di-harmonic approximation), automatic detection can be overriden
+       with --enable-signed-triang-algo=x and --enable-unsigned-triang-algo=x
+       configure script argument though (mandatory for cross-compilation)
+     - do not automatically pick optimized gcc flags if the user already
+       provided some on his own (as CXXFLAGS)
+     - added compile time option to disable processing of All-Notes-Off MIDI
+       messages
+     - added compile time options to allow disabling the various audio and
+       MIDI drivers
+     - fixed automatic GCC CPU switch detection on PPC
+       (patch by Ebrahim Mayat)
+   * Gigasampler format engine:
+     - extensive synthesis optimization
+       (reimplementation of EGs and LFO(s), removed synthesis parameter
+       prerendering and the synthesis parameter matrix in general, splitting
+       each audio fragment into subfragments now where each subfragment uses
+       constant pitch and filter coefficients. The volume coefficient is
+       linearly interpolated inside a subfragment, unless
+       --disable-interpolate-volume is set.)
+     - fine tuning of the EG modulation parameters
+     - improved filter cutoff calculation by adding support for the
+       following gig parameters: Cutoff freq (used when no cutoff
+       controller is defined), Control invert, Minimum cutoff, Velocity
+       curve and Velocity range. The keyboard tracking now scales
+       cutoff frequency instead of resonance.
+     - added support for gig parameter Resonance.
+     - fixed bug in sysex handling (patch by Juan Linietsky)
+     - added global volume attenuation of -9 dB (0.35f) to prevent clipping
+       which can be overridden with --enable-global-attenuation
+     - EG fixes: made the length of "attack hold" stage more
+       accurate. Release stage can now start before attack stage
+       ends. Cancel release didn't work when sustain was zero. Attack
+       time now has a minimal value to prevent clicks.
+     - fixed pitch changes larger than one octave
+     - fixed EG3 (pitch envelope) synthesis which was neutral all the time
+     - implemented portamento mode and solo mode (a.k.a 'mono mode'):
+       all modes can be altered via standard GM messages, that is CC5 for
+       altering portamento time, CC65 for enabling / disabling portamento
+       mode, CC126 for enabling solo mode and CC127 for disabling solo mode
+     - fine tuning of the curves for volume (CC7), pan (CC10 and gig
+       parameter) and crossfade
+     - added support for the "attenuation controller threshold" gig
+       parameter
+     - added smoothing of volume changes caused by control change
+       messages
+     - sample loop parameters are now taken from the DimensionRegion
+       instead of the wave chunk
+     - fixed keyswitching for v3 gigs with a number of keyswitch splits
+       not equal to a power of two
+     - reimplementation of the filter algorithm. The new filter is more
+       accurate and supports all gig filter types, including bandreject
+       and lowpass turbo.
+     - real support for 24 bit samples - samples are not truncated to
+bits anymore
+     - support for aftertouch (channel pressure, not polyphonic
+       aftertouch)
+     - LFO1 behaviour fixed (dampening from max volume instead of
+       amplifying from 0)
+   * LSCP server:
+     - fixed application exit on broken pipe error (fixes bug #20)
+     - fixed the notification messages delay due to lack of
+       network activity (fixes bug #26)
+     - fixed parser bug which occured on space(s) within device parameters
+       (e.g. "SET AUDIO_OUTPUT_CHANNEL_PARAMETER 0 0 SOMEPARAM='foo bar'")
+   * audio driver:
+     - added aRts audio output driver (by no means RT safe)
+   * MIDI driver:
+     - fixed legacy sysex code which caused dispatching of MIDI SysEx
+       messages several times instead of once
+     - API extension for MIDI drivers which already supply exact time stamps
+       for events (i.e. for offline rendering based MIDI drivers)
+     - added checks for bad MIDI data
+   * linuxsampler application:
+     - show available sampler engine types on startup
+   * general changes:
+     - support for muting sampler channels and solo mode of the same, two new
+       LSCP commands ("SET CHANNEL MUTE" and "SET CHANNEL SOLO") and two new
+       fields ("MUTE" and "SOLO") for command "GET CHANNEL INFO" were
+       introduced for this, the behavior is the same like on a mixer console
+       (patch by Grigor Iliev, a bit adjusted). Also added configure option
+       --enable-process-muted-channels which can be used to enable the
+       processing of muted channels.
+     - support for sostenuto pedal
+     - support for monitoring the total number of active voices
+       (new LSCP commands: GET TOTAL_VOICE_COUNT, GET TOTAL_VOICE_COUNT_MAX,
+       SUBSCRIBE TOTAL_VOICE_COUNT, UNSUBSCRIBE TOTAL_VOICE_COUNT)
+     - fixed some memory management errors
+     - fixed some concurrency problems that could lead to crashes when
+       LSCP commands were executed
+     - fixed crash when instrument loading failed previously on the same
+       sampler channel (fixes bug #36)
+ Version 0.3.3 (15 July 2005)
    * packaging changes:
      - fixed compilation with gcc 4.0
+   * Gigasampler format engine:
+     - LFO preprocessing was performed even though the respective LFO was
+       disabled by the instrument patch (minor efficiency fix)
+     - if period time of chosen audio device is too small (< MIN_RELEASE_TIME)
+       for volume ramp downs in the same fragment (needed for current voice
+       stealing implementation) then simply inform the user with a warning
+       about possible click sounds and reduce the volume ramp down
+       appropriately instead of cancelling the audio device connection
  Version 0.3.2 (24 June 2005)
    * packaging changes:

 Legend:



Removed from v.686
 


changed lines


 
Added in v.4016
 Legend:



Removed from v.686
 


changed lines


 
Added in v.4016
-Removed from v.686
+Added in v.4016

	ViewVC Help
Powered by ViewVC