--- linuxsampler/trunk/ChangeLog 2011/08/18 11:32:33 2244 +++ linuxsampler/trunk/ChangeLog 2019/12/27 22:46:08 3678 @@ -1,7 +1,566 @@ -Version CVS HEAD (?) +Version SVN trunk (?) - * plugin changes: - - LV2 Persist + Files support (patch by David Robillard) + * 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. + + * 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 + 2nd 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()". + + * 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. + + * 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 + 2019-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. + + * SFZ format engine: + - Fixed support for regions with loccN/hiccN conditions on more than one + MIDI controller. + + * 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 , 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 @@ -18,6 +577,28 @@ - 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 @@ -42,6 +623,52 @@ - 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 @@ -49,6 +676,19 @@ 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) @@ -121,7 +761,7 @@ - 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 + - lfoN_* and egN_* opcodes defined in group sections are now taken into account - implemented curves - implemented opcodes volume_onccN, volume_curveccN @@ -145,6 +785,75 @@ - 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) @@ -153,14 +862,9 @@ - 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 - * Gigasampler format engine: - - 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) - - * Host plugins: + * 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 @@ -174,15 +878,72 @@ - 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 /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 @@ -220,6 +981,73 @@ - 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 @@ -239,6 +1067,40 @@ 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) @@ -303,6 +1165,7 @@ - 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