--- linuxsampler/trunk/ChangeLog 2016/07/15 20:07:47 2951 +++ linuxsampler/trunk/ChangeLog 2019/08/30 11:40:25 3581 @@ -1,7 +1,193 @@ Version SVN trunk (?) + * 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. + + * 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. + + * 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. + +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 , 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) @@ -24,12 +210,36 @@ (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. @@ -98,6 +308,137 @@ - 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) @@ -522,6 +863,7 @@ "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. @@ -571,7 +913,7 @@ $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 int array variable %KEY_DOWN. - Implemented built-in script function "abs()". - Implemented built-in script function "random()". - Implemented built-in script function "num_elements()". @@ -585,6 +927,7 @@ (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