--- linuxsampler/trunk/ChangeLog 2019/08/30 18:59:21 3586 +++ linuxsampler/trunk/ChangeLog 2021/06/10 12:58:37 3917 @@ -1,5 +1,11 @@ Version SVN trunk (?) + * GigaStudio/Gigasampler format engine: + - Use libgig's new IO-per-thread feature to avoid file I/O concurrency + issues with .gig file. + +Version 2.2.0 (9 May 2021) + * general changes: - Fixed compiler error in Pool.h. - Require C++14 compiler support. @@ -10,6 +16,70 @@ - 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 @@ -138,6 +208,116 @@ - 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()". + - 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. @@ -158,6 +338,52 @@ 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 + 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. + - 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)