/[svn]/linuxsampler/trunk/ChangeLog
ViewVC logotype

Diff of /linuxsampler/trunk/ChangeLog

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2837 by persson, Sun Aug 23 06:14:00 2015 UTC revision 4009 by schoenebeck, Wed Dec 22 15:01:44 2021 UTC
# Line 1  Line 1 
1  Version SVN trunk (?)  Version SVN trunk (?)
2    
3    * general changes:    * general changes:
4        - AbstractEngineChannel: fixed CCs not being forwarded to all
5          VirtualMIDIDevices.
6        - Fix compiler error with release tarball if no Bison installed
7          (SVN version still requires Flex and Bison being installed).
8    
9      * Real-time instrument scripts:
10        - Fix: Do not share compiled instrument scripts among multiple engine
11          channels (sampler parts) as this can lead to crashes and would allow the
12          same global script variables to be accessible from multiple engine
13          channels which would not be the expected behaviour by instrument script
14          authors.
15    
16      * GigaStudio/Gigasampler format engine:
17        - Use libgig's new IO-per-thread feature to avoid file I/O concurrency
18          issues with .gig file.
19        - Use libgig's new method gig::File::GetSample() with method
20          gig::File::CountSamples() instead of now deprecated
21          gig::File::GetFirstSample() / gig::File::GetNextSample() pair.
22        - Use libgig's new method gig::Instrument::GetRegionAt() with method
23          gig::Instrument:CountRegions() instead of now deprecated
24          gig::Instrument::GetFirstRegion() / gig::Instrument::GetNextRegion() pair.
25        - Use libgig's gig::File::GetInstrument() method with method
26          gig::File::CountInstruments() instead of now deprecated
27          gig::File::GetFirstInstrument() / gig::File::GetNextInstrument() pair.
28        - Show a more detailed error message on terminal if an appropriate editor
29          could not be found for a .gig instrument.
30    
31      * MIDI driver:
32        - VirtualMidiDevice: added method Reset() which is e.g. intended to be used
33          in "panic" / MIDI "all sound off" / MIDI "all note off" situations.
34        - VirtualMidiDevice: release all notes on MIDI CC #120 and CC #123.
35    
36    Version 2.2.0 (9 May 2021)
37    
38      * general changes:
39        - Fixed compiler error in Pool.h.
40        - Require C++14 compiler support.
41        - Autoconf: Added m4/ax_cxx_compile_stdcxx.m4 macro which is used
42          for checking in configure for C++14 support (as mandatory
43          requirement) and automatically adds compiler argument if required
44          (e.g. -std=C++14).
45        - RTMath: Implemented floating point comparison methods
46          fEqual32(float,float) and fEqual64(double,double) which take the
47          expected floating point tolerances into account.
48        - Added public API C++ class "LFO", which is a cluster class encapsulating
49          all the sampler's LFO implementations to be used by 3rd party applications
50          (e.g. by Gigedit).
51        - Added int math square LFO implementation.
52        - Added int math saw LFO implementation.
53        - Added numeric complex nr sine LFO implementation.
54        - Marked class LFOTriangleDiHarmonic as deprecated
55          (will be removed in future).
56        - Added LFOAll.h which includes all LFO implementation's header files.
57        - Refactored LFO class names and their file names (PulseLFO -> LFOPulse,
58          LFOSawIntMath -> LFOSawIntMathNew, SawLFO -> LFOSawIntMathOld,
59          SineLFO -> LFOSineBuiltinFn, LFOSine -> LFOSineNumericComplexNr,
60          SquareLFO -> LFOSquarePulse and separated the latter to its own header
61          file).
62        - Renamed type LFOSigned -> LFOTriangleSigned.
63        - Renamed type LFOUnsigned -> LFOTriangleUnsigned.
64        - Using now cubic interpolation as resampling algorithm by default; and
65          linear interpolation is deprecated now.
66        - Event:Init(): memset() entire Event::Param union to zero instead of trying
67          to do that for its individual members; the latter became error prone due
68          to the union's growing complexity meanwhile.
69        - EngineChannel: Overhaul of RPN/NRPN related methods: Added new
70          *Rpn*Parameter*() methods as replacement for previous *Rpn*Controller*()
71          methods and marked the old ones as deprecated; and likewise added new
72          *Nrpn*Parameter*() methods as replacement for previous *Nrpn*Controller*()
73          methods and marked those old ones deprecated as well.
74        - Added support for MIDI CC #38 (data entry LSB): this allows higher value
75          resolution for certain (e.g. hard coded) RPN and NRPN parameters.
76        - Implemented support for compressed RPN/NRPN message sequences (that is to
77          allow processing MIDI data entry messages without always having to be
78          preceded strictly by RPN/NRPN parameter selection messages on each value
79          change).
80        - Added support for MIDI CC #96 (data increment) and MIDI CC #97 (data
81          decrement).
82        - Added support for 'null function RPN/NRPN' (which is RPN/NRPN parameter
83          MSB=127 and LSB=127) and which is disabling subsequent data
84          entry/increment/decrement CC messages.
85        - Fixed crash when editing key groups (a.k.a. exclusive groups) with an
86          instrument editor.
87        - Fixed playing noise at the end of a disk stream under certain conditions.
88        - Fixed potential crash with high pitch at end of RAM playback.
89        - Added configure checks whether C++ compiler supports so called
90          'designated initializers'.
91        - Added global backtraceAsString() function for debugging purposes
92          (POSIX systems only, no Windows implementation yet).
93        - Thread class: Added new methods pushCancelable(), popCancelable(), name(),
94          nameOfCaller() and setNameOfCaller().
95        - configure: Always check for availability of pthread_testcancel() and use
96          it if so (previously it was only used if explicitly enabled by configure
97          option).
98        - Thread class: raise compiler warning if pthread_testcancel() is not
99          available, because it can lead to deadlocks.
100        - Mutex class: Implemented optional bug detection and deadlock debugging
101          features.
102        - Ref<> class is now thread safe (as lock-free and wait-free
103          implementation).
104        - Fixed compilation error with Bison >= 3.6.0.
105        - Fixed rare crash when switching between instruments that had instrument
106          scripts loaded.
107        - Allow EffectChain::InsertEffect() as alternative to
108          EffectChain::AppendEffect() (i.e. with index equal to current chain size).
109        - ConstCapacityArray class: Fixed bug in remove() method.
110        - Fixed crash on certain MIDI RPN and NRPN messages that occurred if no
111          real-time instrument script was loaded.
112    
113      * Real-time instrument scripts:
114        - Added method ScriptVM::setExitResultEnabled() which allows to
115          explicitly enable the built-in exit() function to optionally accept
116          one function argument; the value of the passed exit() function
117          argument will then become available by calling
118          VMExecContext::exitResult() after script execution.
119        - 64 bit support for NKSP integer scripts variables (declare $foo).
120        - Variable names, function names and preprocessor condition names must start
121          with a regular character (a-z or A-Z); starting them with a digit or
122          underscore is not allowed.
123        - NKSP parser fix: equal comparison operator "=" and not equal comparison
124          operator "#" must only accept integer operands.
125        - NKSP language: Implemented support for standard units like Hertz, seconds,
126          Bel including support for metric unit prefixes; so one can now e.g.
127          conveniently use numbers in scripts like "5us" meaning "5 microseconds",
128          or e.g. "12kHz" meaning "12 kilo Hertz", or e.g. "-14mdB" meaning
129          "minus 14 Millidecibel", or e.g. "28c" meaning "28 cents" (for tuning).
130        - NKSP language: Introduced "final" operator "!" which is specifically
131          intended for synthesis parameter values to denote that the synthesis
132          parameter value is intended to be the "final" value for that synthesis
133          parameter that should explicitly be used by the engine and thus causing
134          the sampler engine to ignore all other modulation sources for the same
135          synthesis parameter (like e.g. LFO, EG); by simply prefixing a value,
136          variable or formula with this new "!" operator the expression is marked as
137          being "final".
138        - NKSP script editor API: Added support for detecting standard unit tokens
139          and their potential metric prefix token.
140        - NKSP language: Added support for NKSP real number literals and
141          arithmetic operations on them (e.g. "(3.9 + 2.9) / 12.3 - 42.0").
142        - NKSP language: Added support for NKSP real number (floating point) script
143          variables (declare ~foo).
144        - NKSP language: Added support for NKSP real number (floating point) array
145          script variables (declare ?foo[]).
146        - Built-in script function "message()" accepts now real number argument as
147          well.
148        - Added built-in script function "real_to_int()" and its short hand form
149          "int()" for casting from real number to integer in NKSP scripts.
150        - Added built-in script function "int_to_real()" and its short hand form
151          "real()" for casting from integer to real number in NKSP scripts.
152        - Allow built-in exit() function to potentially accept real number type
153          argument as well.
154        - Built-in script functions may have a different return type depending on
155          the arguments passed to the function.
156        - Built-in script function "abs()" optionally accepts and returns real
157          number.
158        - Built-in script functions "min()" and "max()" optionally accept real
159          number arguments and return real number as result in that case.
160        - NKSP VM API: Allow units and 'final'ness to be returned as result from
161          built-in functions (added methods VMFunction::returnUnitType() and
162          VMFunction::returnsFinal() for that purpose which must be implemented by
163          built-in function implementations).
164        - NKSP language: Allow metric unit prefixes of numeric scalar and array
165          variables to be changed freely at runtime (unlike unit types like Hz etc.
166          which are still sticky, parse-time features of variables which cannot be
167          changed at runtime for the intentional sake of determinism).
168        - NKSP language: 'final' values are prohibited for array variables for now
169          (attempt causes a parsers error).
170        - NKSP language: expressions with unit types (e.g. Hz) are prohibited for
171          conditions of runtime control structures like if(), while(), select()
172          (attempt causes a parser error).
173        - NKSP VM API: Allow built-in functions to perform their own, individual
174          parse time checks of arguments going to be passed to the function at
175          runtime (added method VMFunction::checkArgs() for that purpose).
176        - NKSP language: raise parser warning if only one operand of binary
177          operators (like logical 'or' comparison) contain a 'final' value (because
178          it would always yield in a 'final' result in such cases).
179        - NKSP language: Allow comparison (=, #, <, >, <=, >=) of values with
180          different metric unit prefixes, which will behave as expected (e.g.
181          result of expression '1000us < 2ms' is true).
182        - NKSP language: Allow adding values with different metric unit prefixes
183          (e.g. result of expression '100Hz + 5kHz' is '5100Hz').
184        - NKSP language: Allow subtracting values with different metric unit
185          prefixes (e.g. result of expression '1ms - 20us' is '980us').
186        - NKSP language: Allow multiplying with any metric unit prefixes
187          (e.g. result of expression '2k * 3ms' is '6s'), however multiplications
188          with unit types on both sides (e.g. '2s * 2s') is still prohibited since
189          we don't have any considerable practical use for a term like '4s^2'
190          (hence any attempt multiplying two unit types still causes parser error).
191        - NKSP language: Allow dividing by any metric unit prefixes and allow
192          division of same unit type on both sides (e.g. expression '8kHz / 1000Hz'
193          yields in unit free result '8'). So this is now a way to cast units away
194          e.g. for passing the result to other expressions, certain function calls
195          or variables which are not accepting any units (or that specific unit).
196        - NKSP language: integer arrays and real number arrays can now be converted
197          to strings (e.g. for dumping their content with message() calls for
198          script debugging purposes).
199        - NKSP language: expressions and variables with units are now correctly
200          casted to strings (e.g. with message() calls).
201        - NKSP language: comparing real numbers for equalness (e.g. '~foo = 3.1') or
202          unequalness (e.g. '~foo # 3.1') is now less strict and takes the expected
203          floating point tolerances into account.
204        - NKSP VM API: Added methods VMScalarNumberExpr::evalCastInt() and
205          VMScalarNumberExpr::evalCastReal().
206        - NKSP VM API: Added base class 'VMNumberArrayExpr' for classes
207          'VMIntArrayExpr' and 'VMRealArrayExpr'.
208        - NKSP VM API: replaced all unitPrefix() (parse time) methods by
209          unitFactor() (runtime) methods.
210        - Built-in function "exit()" supports now returning units and 'final'ness
211          for test cases.
212        - The following built-in functions support now units as well: "abs()",
213          "random()", "inc()", "dec()", "in_range()", "min()", "max()",
214          "real_to_int()", "int()", "int_to_real()" and "real()".
215        - Built-in functions "array_equal()", "search()" and "sort()" support now
216          real number arrays (correctly) as well.
217        - Added individual parse time checks of arguments to be passed to built-in
218          functions "random()", "inc()", "dec()", "in_range()", "min()", "max()",
219          "array_equal()" and "search()" specific for their individual purposes.
220        - NKSP VM refactoring: Renamed all methods, functions and classes matching
221          pattern *ScalarNumber* to simply *Number* (that is i.e. classes
222          VMScalarNumberExpr -> VMNumberExpr, ScalarNumberExpr -> NumberExpr,
223          ScalarNumberVariable -> NumberVariable, ScalarNumberBinaryOp ->
224          NumberBinaryOp, VMScalarNumberResultFunction -> VMNumberResultFunction,
225          method VMExpr::asScalarNumberExpr() -> VMExpr::asNumber(), function
226          isScalarNumber() -> isNumber()).
227        - NKSP VM API: Added 4 overridden methods to class VMNumberExpr:
228          evalCastInt(MetricPrefix_t), evalCastInt(MetricPrefix_t,MetricPrefix_t),
229          evalCastReal(MetricPrefix_t), evalCastReal(MetricPrefix_t,MetricPrefix_t)
230          as convenient methods for automatically converting values to expected
231          metric value basis.
232        - Built-in function "wait()" accepts now both integers and real numbers as
233          argument.
234        - NKSP VM API cleanup: Get rid of legacy method
235          VMFunction::argType(vmint iArg) which was already superseded by its new
236          replacement VMFunction::acceptsArgType(vmint iArg, ExprType_t type).
237        - NKSP parser: if wrong argument type was passed to a built-in function and
238          that built-in function accepts more than one data type for the argument,
239          then show all supported data types as parser error message.
240        - Built-in function "play_note()" accepts now real numbers and seconds as
241          unit type as well for its 3rd and 4th function arguments.
242        - The following built-in functions accept now real numbers as well for their
243          2nd function argument: "change_vol()", "change_tune()", "change_cutoff()",
244          "change_attack()", "change_decay()", "change_release()",
245          "change_sustain()", "change_cutoff_attack()", "change_cutoff_decay()",
246          "change_cutoff_sustain()", "change_cutoff_release()",
247          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
248          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
249          "change_pan_time()", "fade_in()", "fade_out()", "change_play_pos()".
250        - Fixed built-in function "change_play_pos()" not having accepted metric
251          prefixes at all.
252        - Fixed the following built-in functions having misinterpreted values given
253          with unit type (for their 2nd argument) as if they were relative values
254          (that is as if they were passed without a unit type): "change_attack()",
255          "change_decay()", "change_release()", "change_cutoff_attack()",
256          "change_cutoff_decay()", "change_cutoff_release()".
257        - Fixed the following built-in functions having applied completely wrong
258          'final' values: "change_sustain()", "change_cutoff_sustain()" (since the
259          respective EGs being their modulation sink assume uint data type with
260          value range 0..1000 instead of 0.0..1.0.
261        - Added individual parse-time checks of function arguments for the following
262          built-in functions: "play_note()", "note_off()", "set_event_mark()",
263          "delete_event_mark()", "by_marks()", "change_cutoff()", "change_attack()",
264          "change_decay()", "change_release()", "change_cutoff_attack()",
265          "change_cutoff_decay()", "change_cutoff_release()",
266          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
267          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()" and
268          "change_pan_time()".
269        - Don't abort function call if unit type was used and at the same time
270          'final' operator was omitted for the primary value argument of the
271          following built-in functions: "change_cutoff()", "change_attack()",
272          "change_decay()", "change_release()", "change_cutoff_attack()",
273          "change_cutoff_decay()", "change_cutoff_release()",
274          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
275          "change_pitch_lfo_freq()", "change_vol_time()", "change_tune_time()",
276          "change_pan_time()", instead imply 'final'ness at runtime and raise an
277          appropriate parser warning at parse time.
278        - Added built-in real number functions "round()", "ceil()", "floor()",
279          "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()", "sin()",
280          "cos()", "tan()", "asin()", "acos()", "atan()".
281        - Added built-in script real number constant "~NI_MATH_PI".
282        - Added built-in script real number constant "~NI_MATH_E".
283        - NKSP language: Allow unary '+' operator.
284        - Added built-in script functions "msb()" and "lsb()".
285        - NKSP language: Added support for RPN event handler
286          ("on rpn ... end on" in instrument scripts).
287        - NKSP language: Added support for NRPN event handler
288          ("on nrpn ... end on" in instrument scripts).
289        - Added built-in read-only variables "$RPN_ADDRESS" and "$RPN_VALUE" which
290          may be read from the new RPN/NRPN script handlers to get the (N)RPN
291          parameter that had been changed and its new value.
292        - Added built-in const variables "$NI_CB_TYPE_RPN" and "$NI_CB_TYPE_NRPN"
293          which are identifying the new (N)RPN handlers as such at script runtime.
294        - Implemented built-in script function "set_rpn()".
295        - Implemented built-in script function "set_nrpn()".
296        - Fix: built-in functions returning an array type were broken and caused a
297          crash when the built-in function's (supposed to be array) result value was
298          used by the script VM.
299        - Removed upper value constraint for 2nd argument of built-in functions
300          "change_amp_lfo_freq()", "change_cutoff_lfo_freq()",
301          "change_pitch_lfo_freq()","change_reso()", "change_cutoff()",
302          "change_amp_lfo_depth()", "change_cutoff_lfo_depth()" and
303          "change_pitch_lfo_depth()", to allow e.g. passing value 2000000 to double
304          the LFO frequency / resonance / cutoff frequency.
305        - Reduced code involved for parsing NKSP variable declarations by using 2
306          generalized grammar rules with optional components (i.e. optional value
307          assignment and optional variable qualifiers) instead of previous linear
308          combinations of grammar rules, which also fixes some edge case.
309        - NKSP language parser: track code block locations also by a) raw byte
310          position in NKSP source code string and b) length of that code block in
311          bytes (along to the already existing code block tracking by line/column);
312          and added appropriate new members to public C++ API classes like
313          'firstByte' and 'lengthBytes' to class VMSourceToken and struct CodeBlock.
314        - NKSP language: Added support for 'patch' variable qualifier (capture their
315          locations and allow replacement of their assignment expression via VM C++
316          API).
317        - Fixed incorrect EG times if standard measuring unit was passed to built-in
318          functions "change_attack()", "change_decay()" or "change_release()".
319        - Fixed intermediate function result values never having reflected any
320          standard measuring unit type.
321        - Fixed re-entrant issue with function calls which caused wrong result
322          values if the same function was called multiple times in a term
323          (specifically if metric prefixes were used).
324        - NKSP language: Just throw a warning, not an error if an array variable of
325          size zero was declared.
326        - NKSP language: Allow omitting explicit array size on array variable
327          declaration if combined with immediate value assignment
328          (e.g. declare %foo[] := ( 1, 2, 3 ) ).
329        - NKSP language: emit warning if an array variable was declared with bigger
330          array size than amount of initial values been assigned, and initialize the
331          missing array elements with zero in this case.
332        - Fixed built-in NKSP exit() function to behave as return statement.
333        - NKSP parser: Fixed crash if unary '-' operator was used on a non-number
334          data type.
335        - NKSP VM: Fixed the "release" handler being executed too often under
336          certain situations if polyphonic data was passed from "note" handler to
337          "release" handler.
338        - Fixed memory leak in NKSP parser: string tokens were allocated as C
339          strings and never freed.
340        - Fixed incorrect polyphonic data transfer from wrong note handler to
341          release handler; which also fixes no release handler being executed
342          sometimes, and due to the latter it also fixes potential crashes as some
343          polyphonic script events were never released and the engine hence was
344          running out of free script events.
345        - Fixed crash when handling array results of built-in functions
346          (e.g. "num_elements(by_marks($MARK_1)").
347        - NKSP VM: Fixed dead note events not been removed from user's event groups
348          (i.e. causing incorrect behaviour of built-in NKSP functions by_marks()
349          and set_event_mark() after max. size of event group list was exhausted).
350    
351      * test cases:
352        - Fixed compiler errors in test cases.
353        - Updated README for how to compile & run test cases.
354        - Updated test case
355          MutexTest::testDoubleLockStillBlocksConcurrentThread() to latest
356          expected behaviour of the Mutex class implementation (recursive
357          mutex type).
358        - Added test cases for NKSP core language aspects and core built-in
359          functions.
360        - Fixed thread tests segfaulting on Linux.
361        - NKSP: Added real number test cases for built-in functions exit(),
362          int_to_real(), real(), real_to_int() and int(), as well as for the
363          plus, minus and negate language operators.
364        - Added massive amount of NKSP test cases for standard measuring units and
365          'final' operator usage cases.
366        - Added NKSP test cases for (floating point tolerance aware) real number
367          equalness / unequalness comparison.
368        - Added NKSP int array and real array tests for value assignment and
369          initialization of arrays.
370        - Added NKSP test cases for built-in functions "round()", "ceil()",
371          "floor()", "sqrt()", "log()", "log2()", "log10()", "exp()", "pow()",
372          "sin()", "cos()", "tan()", "asin()", "acos()", "atan()".
373        - Added NKSP test cases for unary '+' operator.
374        - Added NKSP test cases for core built-in variables.
375        - Added thorough NKSP test cases for variable declarations.
376    
377      * GigaStudio/Gigasampler format engine:
378        - LFOTriangleIntMath and LFOTriangleIntAbsMath: Fixed FlipPhase=true
379          behaviour for start_level_mid.
380        - Changed LFO start levels: LFO1 and LFO2 both to mid, LFO3 to max. start
381          level (see discussion "GigaStudio LFO compatibility" on mailing list
382          from 2019-09-26 for details).
383        - Changed default wave form for all 3 LFOs to sine (instead of triangle;
384          see discussion "GigaStudio LFO compatibility" on mailing list from
385          2019-09-26 for details).
386        - Format extension: Added support for different LFO wave forms (currently
387          either sine [default], triangle, saw or square).
388        - Format extension: Added support for LFO phase displacement (0°..360°).
389        - Format extension: Added support for flipping LFO polarity on LFO 3
390          (in the original gig format this was only available for LFO 1 and LFO 2).
391        - Format extension: Support for additional filter types:
392          lowpass 1/2/4/6-pole, highpass 1/2/4/6-pole, bandpass 2-pole,
393          bandreject 2-pole.
394        - Fixd potential crash with polynomial interpolator and max. pitch.
395        - If minimum cutoff is defined, remap cutoff controller CC values to really
396          span the entire possible cutoff range (and avoiding a dead controller
397          zone).
398        - Implemented support for loading instrument scripts with 'patch' variables
399          (by patching these script variables with potentially overridden ones by
400          gig Instrument).
401    
402      * SFZ format engine:
403        - Fixed support for regions with loccN/hiccN conditions on more than one
404          MIDI controller.
405        - Fixed internal opcode 'xfin_hivel' falsely being set by user opcode
406          'xfin_lovel' (patch by Christian Czezatke).
407    
408      * Benchmarks:
409        - Fixed benchmarks/triang.cpp falsely having favoured "int math abs"
410          algorithm (since result of 2nd run was not accumulated).
411        - Added benchmark for saw wave (benchmarks/saw.cpp).
412        - Added benchmark for sine wave (benchmarks/sine.cpp).
413        - Added benchmark for square wave (benchmarks/square.cpp).
414        - Increased amount of benchmarks runs by factor 6 to achieve benchmark times
415          which are large enough on modern systems.
416    
417    Version 2.1.1 (27 Jul 2019)
418    
419      * Real-time instrument scripts:
420        - Fixed behavior of built-in NKSP functions change_sustain(),
421          change_cutoff_attack(), change_cutoff_decay(), change_cutoff_sustain()
422          and change_cutoff_release().
423    
424      * general changes:
425        - Only play release trigger samples on sustain pedal up if this behaviour
426          was explicitly requested by the instrument (otherwise only on note-off).
427        - Fixed compiler warnings.
428        - Fixed compilation error when cross-compiling to Mac.
429        - FX Sends: Provide more useful error messages on routing problems
430          (see bug #169).
431        - LSCP doc: Be more clear describing the two distinct approaches
432          of using external vs. internal effects (see bug #169).
433        - "optional" class: Fixed comparison operators.
434    
435      * Gigasampler/GigaStudio format engine:
436        - Format extension: If requested by instrument then don't play release
437          trigger sample on note-off events.
438    
439      * SFZ format engine:
440        - Fixed memory leak when releasing samples
441          (fixes bug #307, patch by Jacek Roszkowski)
442        - Fixed potential crash when a sample is shared by more than one region
443          (fixes bug #308, patch by Jacek Roszkowski).
444        - Opcode 'sample': Added support for built-in sample '*silence'
445          (fixes bug #310, patch by Jacek Roszkowski).
446    
447    Version 2.1.0 (25 Nov 2017)
448    
449      * SFZ format engine:
450        - added support for <global>, <master> and #define (patch by Alby M)
451        - Removed code duplication in SFZ file loading code.
452        - Added support for sfz extension opcode 'script' which may be used to
453          load real-time instrument script file (NKSP script language).
454        - Implemented opcode set_ccN (initial patch by Giovanni Senatore).
455        - Fixed unintended volume fade-in of voices under certain conditions.
456        - sfz parser: allow missing space between header and opcode
457    
458      * Gigasampler/GigaStudio format engine:
459        - Fixed clicks and pumping noise with Lowpass Turbo filter on very low
460          cutoff settings.
461        - Got rid of resembling an ancient GSt misbehavior which did not pitch at
462          all if an up-pitch of more than 40 semi tones was requested (I don't
463          think there is any stock gig sound that requires this behavior to
464          resemble its original sound).
465        - Added support for controlling whether the individual EGADSR stages may
466          be aborted (as LinuxSampler extension to the original GigaStudio 4
467          format).
468    
469      * general changes:
470      - fixed printf type errors (mostly in debug messages)      - fixed printf type errors (mostly in debug messages)
471        - use unique_ptr instead of auto_ptr when building with C++11
472        - Added RTAVLTree class which is a real-time safe ordered multi-map, thus
473          allowing to sort data efficiently in real-time safe manner.
474        - RTList class: added methods for moving/inserting elements to arbitrary
475          position within a list.
476        - RTList class: added method fromPtr() for creating an Iterator object from
477          a raw element pointer.
478        - Attempt to partly fix resetting engine channels vs. resetting engine, an
479          overall cleanup of the Reset*(), ConnectAudioDevice(),
480          DisconnectAudioDevice() API methods would still be desirable though,
481          because the current situation is still inconsistent and error prone.
482        - Active voices are now internally grouped to "Note" objects, instead of
483          being directly assigned to a keyboard key. This allows more fine graded
484          processing of voices, which is i.e. required for certain instrument
485          script features.
486        - Fix: Release trigger voices were not spawned on sustain pedal up
487          (CC #64) events.
488        - Fix: Release trigger voices can now also distinguish correctly between
489          note-off and sustain pedal up events.
490        - All engines: Increased ramp speed of volume smoother and pan smoother
491          (while slow rate of crossfade smoother is preserved) to allow quick
492          volume and pan changes by instrument scripts for instance.
493        - gig/sf2/sfz: Fixed aftertouch channel pressure events being processed
494          properly and thus were ignored for certain uses.
495        - Added new C++ API method
496          VirtualMidiDevice::SendChannelPressureToSampler().
497        - windows, 32-bit: fixed potential crashes by making sure the stack in
498          sub threads is 16-byte aligned
499        - fixed numerous compiler warnings
500        - Fixed invalid (note-on) event ID being assigned to new Note objects.
501        - Revised fundamental C++ classes "Thread", "Mutex" and "Condition" which
502          fixes potential undefined behavior.
503        - Fixed Note object leak when triggering notes on keys which did not
504          have a valid sample mapped (fixes bug #252).
505        - Fixed compilation errors when compiling with CONFIG_DEVMODE enabled.
506        - linuxsampler binary fix: option --create-instruments-db ignored
507          subsequent optional argument due to glibc's implementation oddity
508          which expects a "=" sign, but no space between them.
509    
510      * packaging changes:
511        - removed unnecessary dependency to libuuid
512          (originated by libgig's usage of it)
513        - Automake: set environment variable GCC_COLORS=auto to allow GCC to
514          auto detect whether it (sh/c)ould output its messages in color.
515        - Debian: Fixed packaging error about invalid "Source-Version"
516          substitution variable.
517        - Debian: Raised Debian compatibility level to Debian 9 "Stretch".
518        - Debian: Added build dependency to libsqlite3-dev for building
519          linuxsampler with instruments DB support.
520    
521      * Real-time instrument scripts:
522        - Implemented scheduler for delayed MIDI events and for suspended scripts.
523        - Built-in script function "wait()": implemented support for function's
524          "duration-us" argument, thus scripts using this function are now
525          correctly resumed after the requested amount of microseconds.
526        - Built-in script function "play_note()": implemented support for
527          function's "duration-us" argument, thus notes triggered with this
528          argument are now correctly released after the requested amount of
529          microseconds.
530        - Fix: script events were not cleared when engine channel was reset,
531          potentially causing undefined behavior.
532        - Fixed crash which happened when trying to reference an undeclared
533          variable.
534        - Built-in script function "play_note()": Added support for passing
535          special value -1 for "duration-us" argument, which will cause the
536          triggered note to be released once the original note was released.
537        - Instrument script classes now exported with the liblinuxsampler C++ API.
538        - Added new API method ScriptVM::syntaxHighlighting() which provides
539          a convenient syntax highlighting backend for external instrument
540          script editor applications.
541        - Added new C++ API class "ScriptVMFactory".
542        - Extended parser issues to provide not only first line and first
543          column, but also last line and last column of issue (thus marking
544          the precise span of the issue within the source code).
545        - Reload script automatically after being modified by an instrument
546          editor.
547        - NKSP language grammar correction: allow empty event handler bodies
548          like "on note end on".
549        - Implemented built-in script function "change_vol()".
550        - Implemented built-in script function "change_tune()".
551        - Implemented built-in script function "change_pan()".
552        - Implemented built-in script function "change_cutoff()".
553        - Implemented built-in script function "change_reso()".
554        - Implemented built-in script function "event_status()".
555        - Added built-in script constants "$EVENT_STATUS_INACTIVE" and
556          "$EVENT_STATUS_NOTE_QUEUE" both for being used as flags for
557          "event_status()" function.
558        - NKSP language: Added support for bitwise operators ".or.", ".and."
559          and ".not.".
560        - NKSP language scanner: Fixed IDs matching to require at least one
561          character (i.e. when matching function names or variable names).
562        - NKSP language scanner: disabled unusued rules.
563        - Fixed behavior of play_note() and note_off() functions which must
564          be distinguished engine internally from "real" MIDI note on/off
565          events in order to avoid misbehaviors like hanging notes.
566        - Implemented built-in script variable "$KSP_TIMER".
567        - Implemented built-in script variable "$NKSP_REAL_TIMER".
568        - Implemented built-in script variable "$NKSP_PERF_TIMER".
569        - Implemented built-in script variable "$ENGINE_UPTIME".
570        - Implemented built-in script function "inc()".
571        - Implemented built-in script function "dec()".
572        - NKSP language fix: division expressions were evaluated too often.
573        - NKSP language fix: string concatenation operator was right
574          associative instead of left (to right).
575        - NKSP language correction: allow empty statements in entire language
576          (i.e. "if end if").
577        - Implemented built-in script function "stop_wait()".
578        - Implemented built-in script variable "$NI_CALLBACK_ID".
579        - Implemented built-in script variable "$NI_CALLBACK_TYPE".
580        - Implemented built-in script variable "$NKSP_IGNORE_WAIT".
581        - Added support for read-only built-in variables (respectively
582          handled by the script parser).
583        - Added built-in script constant "$NI_CB_TYPE_INIT".
584        - Added built-in script constant "$NI_CB_TYPE_NOTE".
585        - Added built-in script constant "$NI_CB_TYPE_RELEASE".
586        - Added built-in script constant "$NI_CB_TYPE_CONTROLLER".
587        - NKSP Language: Added support for user defined script functions.
588        - Implemented built-in script function "change_attack()".
589        - Implemented built-in script function "change_decay()".
590        - Implemented built-in script function "change_release()".
591        - Fixed all change_*() built-in script functions to apply their
592          synthesis parameter changes immediately in case the respective note
593          was triggered at the same time, instead of scheduling the parameter
594          change, especially because it would cause some parameter types's
595          changes either to be ramped (i.e. change_vol()) or other types even
596          to have not effect at all (i.e. change_attack()).
597        - Implemented built-in script function "sh_left()".
598        - Implemented built-in script function "sh_right()".
599        - Implemented built-in script function "min()".
600        - Implemented built-in script function "max()".
601        - NKSP Fix: "init" event handler was not always executed when a script
602          was loaded.
603        - NKSP built-in wait() script function: abort script execution if
604          a negative or zero wait time was passed as argument (since this is
605          a common indication of a bug either of the script or even of the
606          engine, which could lead to RT instability or even worse).
607        - ScriptVM: Implemented automatic suspension of RT safety
608          threatening scripts.
609        - Provide more user friendly error messages on syntax errors.
610        - Fixed NKSP parser warning "Not a statement" when assigning an
611          initializer list to an array variable.
612        - Implemented built-in script array variable "%ALL_EVENTS".
613        - Implemented built-in script function "in_range()".
614        - Implemented built-in script function "change_amp_lfo_depth()".
615        - Implemented built-in script function "change_amp_lfo_freq()".
616        - Implemented built-in script function "change_pitch_lfo_depth()".
617        - Implemented built-in script function "change_pitch_lfo_freq()".
618        - Implemented built-in script function "change_vol_time()".
619        - Implemented built-in script function "change_tune_time()".
620        - Implemented built-in script function "fade_in()".
621        - Implemented built-in script function "fade_out()".
622        - Fixed acceptance of wrong data type of parameters passed to built-in
623          script functions "change_vol()", "change_tune()", "change_pan()",
624          "change_cutoff()", "change_reso()", "change_attack()", "change_decay()",
625          "change_release()", "change_amp_lfo_depth()", "change_amp_lfo_freq()",
626          "change_pitch_lfo_depth()" and "change_pitch_lfo_freq()".
627        - Added built-in script function "get_event_par()" and implemented some
628          of its possible parameter selections.
629        - Added built-in script function "set_event_par()" and implemented some
630          of its possible parameter selections.
631        - Fixed a bunch of scheduler time related bugs.
632        - Fixed polyphonic variables not being reset to zero after usage.
633        - Built-in "ignore_event()" function: argument is now optional, like with
634          built-in function "ignore_controller()".
635        - Implemented built-in script function "change_velo()".
636        - Implemented built-in script function "change_note()".
637        - Adjusted behavior of "change_vol()" and "change_tune()" to a more
638          intuitive behavior if used in combination with "change_vol_time()" or
639          "change_tune_time()" respectively: now tuning/volume changes are only
640          assigned (without delay) immediately to a new note if the respective
641          timing function has not been called before, otherwise the volume/tuning
642          changes are automatically faded (before, only the event's time stamp was
643          relevant).
644         - Implemented built-in script function "array_equal()".
645         - Implemented built-in script function "search()".
646         - Implemented built-in script function "sort()".
647         - NKSP Fix: Never suspend "init" event handlers.
648         - Implemented built-in script function "same_region()" (currently only
649           available for gig format engine).
650         - Added built-in script constant "$NKSP_LINEAR".
651         - Added built-in script constant "$NKSP_EASE_IN_EASE_OUT".
652         - Implemented built-in script function "change_vol_curve()".
653         - Implemented built-in script function "change_tune_curve()".
654         - built-in "play_note()" function now supports a sample playback start
655           offset with argument 3, where special value -1 means to use the regular
656           sample offset as defined by the instrument file.
657         - Built-in array variable %KEY_DOWN[] is now a read-only variable.
658         - Built-in variable $EVENT_NOTE is now a read-only variable.
659         - Built-in variable $EVENT_VELOCITY is now a read-only variable.
660         - built-in "play_note()" function now accepts -2 for its fourth argument
661           (note duration) which means the life time of the note shall be sticked
662           to the requested note number of argument 1.
663         - Fix: built-in "play_note()" function now returns 0 as result value if
664           -1 was passed for its fourth argument (note duration) and the respective
665           parent note is already gone.
666        - Implemented built-in script function "change_play_pos()".
667        - NKSP language: Added support for user declared const array variables.
668        - NKSP language: Raise parser warning if array variable is accessed with
669          an index that exceeds the array's size.
670        - NKSP language fix: Unknown characters were not handled correctly.
671        - NKSP language: Added support for "synchronized .. end synchronized"
672          code blocks.
673        - Implemented built-in script function "abort()" which allows to abort
674          another script handler by passing its callback ID.
675        - Fixed potential memory access bug and potential undefined behavior of
676          "init" event handlers.
677        - Print a time stamp along to each call of built-in function "message()".
678        - ScriptVM API: Added VMParserContext::preprocessorComments() which allows
679          to retrieve all code blocks filtered out by the preprocessor.
680        - Added built-in script function "fork()".
681        - Added built-in array variable %NKSP_CALLBACK_CHILD_ID[].
682        - Added built-in variable $NKSP_CALLBACK_PARENT_ID.
683        - Fixed potential crash when accessing dynamic built-in array variables.
684        - Added built-in script function "callback_status()".
685        - Added built-in constant $CALLBACK_STATUS_TERMINATED.
686        - Added built-in constant $CALLBACK_STATUS_QUEUE.
687        - Added built-in constant $CALLBACK_STATUS_RUNNING.
688        - Removed max. value limitation of built-in functions "change_attack()",
689          "change_decay()" and "change_release()" to i.e. allow passing 2000000
690          for doubling the respective time.
691        - NKSP script editor syntax highlighting API: Fixed app termination due
692          to a lexer start condition stack underrun.
693        - NKSP preprocessor: Fixed wrong behavior on nested USE_CODE_IF() and
694          USE_CODE_IF_NOT() preprocessor statements.
695        - NKSP: Added built-in preprocessor condition NKSP_NO_MESSAGE, which
696          can be set to disable all subsequent built-in "message()" function calls
697          on preprocessor level.
698        - Implemented built-in script function "change_sustain()".
699        - NKSP script editor syntax highlighting API: catch all fatal lexer errors,
700          to avoid the editor app to crash on ill-formed text input.
701        - Added built-in script function "change_pan_time()".
702        - Added built-in script function "change_pan_curve()".
703        - Added built-in script function "change_cutoff_attack()".
704        - Added built-in script function "change_cutoff_decay()".
705        - Added built-in script function "change_cutoff_sustain()".
706        - Added built-in script function "change_cutoff_release()".
707        - Added built-in script function "change_cutoff_lfo_depth()".
708        - Added built-in script function "change_cutoff_lfo_freq()".
709    
710      * Instruments DB:
711        - Fixed memory access bug of general DB access code which lead to
712          undefined behavior.
713        - Cleanup of instruments DB file creation and opening code.
714        - The instrument DB path of linuxsampler's --create-instruments-db argument
715          is now optional, if it is missing, then a default location is used.
716        - Added support for scanning SFZ (.sfz) files.
717        - Added support for scanning Sound Font (.sf2) files.
718        - Fixed undefined DB transaction behavior.
719    
720  Version 2.0.0 (15 July 2015)  Version 2.0.0 (15 July 2015)
721    
# Line 426  Version 2.0.0 (15 July 2015) Line 1140  Version 2.0.0 (15 July 2015)
1140        "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"        "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"
1141      - provide comprehensive error messages on LSCP syntax errors      - provide comprehensive error messages on LSCP syntax errors
1142        (suggesting expected next non-terminal symbols)        (suggesting expected next non-terminal symbols)
1143        - Fixed client connection not being closed after network errors.
1144    
1145    * LSCP shell:    * LSCP shell:
1146      - Added support for auto correction of obvious and trivial syntax mistakes.      - Added support for auto correction of obvious and trivial syntax mistakes.
# Line 475  Version 2.0.0 (15 July 2015) Line 1190  Version 2.0.0 (15 July 2015)
1190        $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.        $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.
1191      - Giga format scripts: Implemented built-in script function      - Giga format scripts: Implemented built-in script function
1192        "gig_set_dim_zone(event_id, dimension, zone)".        "gig_set_dim_zone(event_id, dimension, zone)".
1193      - Implemented built-in script int array variable $KEY_DOWN.      - Implemented built-in script int array variable %KEY_DOWN.
1194      - Implemented built-in script function "abs()".      - Implemented built-in script function "abs()".
1195      - Implemented built-in script function "random()".      - Implemented built-in script function "random()".
1196      - Implemented built-in script function "num_elements()".      - Implemented built-in script function "num_elements()".
# Line 489  Version 2.0.0 (15 July 2015) Line 1204  Version 2.0.0 (15 July 2015)
1204        (i.e. return value of new script function "by_marks()").        (i.e. return value of new script function "by_marks()").
1205      - Pass/preserve polyphonic variable data from respective "note" event      - Pass/preserve polyphonic variable data from respective "note" event
1206        handler to "release" event handler.        handler to "release" event handler.
1207        - Fixed crash when using built-in script function "by_marks()".
1208    
1209    * Bug fixes:    * Bug fixes:
1210      - Fixed crash which may occur when MIDI key + transpose is out of range      - Fixed crash which may occur when MIDI key + transpose is out of range

Legend:
Removed from v.2837  
changed lines
  Added in v.4009

  ViewVC Help
Powered by ViewVC