--- linuxsampler/trunk/ChangeLog 2017/06/21 20:59:06 3283 +++ linuxsampler/trunk/ChangeLog 2019/08/30 17:51:24 3585 @@ -1,5 +1,194 @@ 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. + - 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. + + * 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. @@ -7,10 +196,18 @@ 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) @@ -44,12 +241,25 @@ 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. @@ -207,6 +417,38 @@ 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