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

Diff of /linuxsampler/trunk/ChangeLog

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

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

Legend:
Removed from v.2568  
changed lines
  Added in v.3986

  ViewVC Help
Powered by ViewVC