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

Diff of /linuxsampler/trunk/ChangeLog

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

revision 2951 by schoenebeck, Fri Jul 15 20:07:47 2016 UTC revision 3584 by schoenebeck, Fri Aug 30 13:33:32 2019 UTC
# Line 1  Line 1 
1  Version SVN trunk (?)  Version SVN trunk (?)
2    
3      * general changes:
4        - Fixed compiler error in Pool.h.
5        - Require C++14 compiler support.
6        - Autoconf: Added m4/ax_cxx_compile_stdcxx.m4 macro which is used
7          for checking in configure for C++14 support (as mandatory
8          requirement) and automatically adds compiler argument if required
9          (e.g. -std=C++14).
10        - RTMath: Implemented floating point comparison methods
11          fEqual32(float,float) and fEqual64(double,double) which take the
12          expected floating point tolerances into account.
13    
14      * Real-time instrument scripts:
15        - Added method ScriptVM::setExitResultEnabled() which allows to
16          explicitly enable the built-in exit() function to optionally accept
17          one function argument; the value of the passed exit() function
18          argument will then become available by calling
19          VMExecContext::exitResult() after script execution.
20        - 64 bit support for NKSP integer scripts variables (declare $foo).
21        - Variable names, function names and preprocessor condition names must start
22          with a regular character (a-z or A-Z); starting them with a digit or
23          underscore is not allowed.
24        - NKSP parser fix: equal comparison operator "=" and not equal comparison
25          operator "#" must only accept integer operands.
26        - NKSP language: Implemented support for standard units like Hertz, seconds,
27          Bel including support for metric unit prefixes; so one can now e.g.
28          conveniently use numbers in scripts like "5us" meaning "5 microseconds",
29          or e.g. "12kHz" meaning "12 kilo Hertz", or e.g. "-14mdB" meaning
30          "minus 14 Millidecibel", or e.g. "28c" meaning "28 cents" (for tuning).
31        - NKSP language: Introduced "final" operator "!" which is specifically
32          intended for synthesis parameter values to denote that the synthesis
33          parameter value is intended to be the "final" value for that synthesis
34          parameter that should explicitly be used by the engine and thus causing
35          the sampler engine to ignore all other modulation sources for the same
36          synthesis parameter (like e.g. LFO, EG); by simply prefixing a value,
37          variable or formula with this new "!" operator the expression is marked as
38          being "final".
39        - NKSP script editor API: Added support for detecting standard unit tokens
40          and their potential metric prefix token.
41        - NKSP language: Added support for NKSP real number literals and
42          arithmetic operations on them (e.g. "(3.9 + 2.9) / 12.3 - 42.0").
43        - NKSP language: Added support for NKSP real number (floating point) script
44          variables (declare ~foo).
45        - NKSP language: Added support for NKSP real number (floating point) array
46          script variables (declare ?foo[]).
47        - Built-in script function "message()" accepts now real number argument as
48          well.
49        - Added built-in script function "real_to_int()" and its short hand form
50          "int()" for casting from real number to integer in NKSP scripts.
51        - Added built-in script function "int_to_real()" and its short hand form
52          "real()" for casting from integer to real number in NKSP scripts.
53        - Allow built-in exit() function to potentially accept real number type
54          argument as well.
55        - Built-in script functions may have a different return type depending on
56          the arguments passed to the function.
57        - Built-in script function "abs()" optionally accepts and returns real
58          number.
59        - Built-in script functions "min()" and "max()" optionally accept real
60          number arguments and return real number as result in that case.
61        - NKSP VM API: Allow units and 'final'ness to be returned as result from
62          built-in functions (added methods VMFunction::returnUnitType() and
63          VMFunction::returnsFinal() for that purpose which must be implemented by
64          built-in function implementations).
65        - NKSP language: Allow metric unit prefixes of numeric scalar and array
66          variables to be changed freely at runtime (unlike unit types like Hz etc.
67          which are still sticky, parse-time features of variables which cannot be
68          changed at runtime for the intentional sake of determinism).
69        - NKSP language: 'final' values are prohibited for array variables for now
70          (attempt causes a parsers error).
71        - NKSP language: expressions with unit types (e.g. Hz) are prohibited for
72          conditions of runtime control structures like if(), while(), select()
73          (attempt causes a parser error).
74        - NKSP VM API: Allow built-in functions to perform their own, individual
75          parse time checks of arguments going to be passed to the function at
76          runtime (added method VMFunction::checkArgs() for that purpose).
77        - NKSP language: raise parser warning if only one operand of binary
78          operators (like logical 'or' comparison) contain a 'final' value (because
79          it would always yield in a 'final' result in such cases).
80        - NKSP language: Allow comparison (=, #, <, >, <=, >=) of values with
81          different metric unit prefixes, which will behave as expected (e.g.
82          result of expression '1000us < 2ms' is true).
83        - NKSP language: Allow adding values with different metric unit prefixes
84          (e.g. result of expression '100Hz + 5kHz' is '5100Hz').
85        - NKSP language: Allow subtracting values with different metric unit
86          prefixes (e.g. result of expression '1ms - 20us' is '980us').
87        - NKSP language: Allow multiplying with any metric unit prefixes
88          (e.g. result of expression '2k * 3ms' is '6s'), however multiplications
89          with unit types on both sides (e.g. '2s * 2s') is still prohibited since
90          we don't have any considerable practical use for a term like '4s^2'
91          (hence any attempt multiplying two unit types still causes parser error).
92        - NKSP language: Allow dividing by any metric unit prefixes and allow
93          division of same unit type on both sides (e.g. expression '8kHz / 1000Hz'
94          yields in unit free result '8'). So this is now a way to cast units away
95          e.g. for passing the result to other expressions, certain function calls
96          or variables which are not accepting any units (or that specific unit).
97        - NKSP language: integer arrays and real number arrays can now be converted
98          to strings (e.g. for dumping their content with message() calls for
99          script debugging purposes).
100        - NKSP language: expressions and variables with units are now correctly
101          casted to strings (e.g. with message() calls).
102        - NKSP language: comparing real numbers for equalness (e.g. '~foo = 3.1') or
103          unequalness (e.g. '~foo # 3.1') is now less strict and takes the expected
104          floating point tolerances into account.
105        - NKSP VM API: Added methods VMScalarNumberExpr::evalCastInt() and
106          VMScalarNumberExpr::evalCastReal().
107        - NKSP VM API: Added base class 'VMNumberArrayExpr' for classes
108          'VMIntArrayExpr' and 'VMRealArrayExpr'.
109        - NKSP VM API: replaced all unitPrefix() (parse time) methods by
110          unitFactor() (runtime) methods.
111        - Built-in function "exit()" supports now returning units and 'final'ness
112          for test cases.
113        - The following built-in functions support now units as well: "abs()",
114          "random()", "inc()", "dec()", "in_range()", "min()", "max()",
115          "real_to_int()", "int()", "int_to_real()" and "real()".
116        - Built-in functions "array_equal()", "search()" and "sort()" support now
117          real number arrays (correctly) as well.
118        - Added individual parse time checks of arguments to be passed to built-in
119          functions "random()", "inc()", "dec()", "in_range()", "min()", "max()",
120          "array_equal()" and "search()" specific for their individual purposes.
121        - NKSP VM refactoring: Renamed all methods, functions and classes matching
122          pattern *ScalarNumber* to simply *Number* (that is i.e. classes
123          VMScalarNumberExpr -> VMNumberExpr, ScalarNumberExpr -> NumberExpr,
124          ScalarNumberVariable -> NumberVariable, ScalarNumberBinaryOp ->
125          NumberBinaryOp, VMScalarNumberResultFunction -> VMNumberResultFunction,
126          method VMExpr::asScalarNumberExpr() -> VMExpr::asNumber(), function
127          isScalarNumber() -> isNumber()).
128        - NKSP VM API: Added 4 overridden methods to class VMNumberExpr:
129          evalCastInt(MetricPrefix_t), evalCastInt(MetricPrefix_t,MetricPrefix_t),
130          evalCastReal(MetricPrefix_t), evalCastReal(MetricPrefix_t,MetricPrefix_t)
131          as convenient methods for automatically converting values to expected
132          metric value basis.
133        - Built-in function "wait()" accepts now both integers and real numbers as
134          argument.
135    
136      * test cases:
137        - Fixed compiler errors in test cases.
138        - Updated README for how to compile & run test cases.
139        - Updated test case
140          MutexTest::testDoubleLockStillBlocksConcurrentThread() to latest
141          expected behaviour of the Mutex class implementation (recursive
142          mutex type).
143        - Added test cases for NKSP core language aspects and core built-in
144          functions.
145        - Fixed thread tests segfaulting on Linux.
146        - NKSP: Added real number test cases for built-in functions exit(),
147          int_to_real(), real(), real_to_int() and int(), as well as for the
148          plus, minus and negate language operators.
149        - Added massive amount of NKSP test cases for standard measuring units and
150          'final' operator usage cases.
151        - Added NKSP test cases for (floating point tolerance aware) real number
152          equalness / unequalness comparison.
153    
154    Version 2.1.1 (27 Jul 2019)
155    
156      * Real-time instrument scripts:
157        - Fixed behavior of built-in NKSP functions change_sustain(),
158          change_cutoff_attack(), change_cutoff_decay(), change_cutoff_sustain()
159          and change_cutoff_release().
160    
161      * general changes:
162        - Only play release trigger samples on sustain pedal up if this behaviour
163          was explicitly requested by the instrument (otherwise only on note-off).
164        - Fixed compiler warnings.
165        - Fixed compilation error when cross-compiling to Mac.
166        - FX Sends: Provide more useful error messages on routing problems
167          (see bug #169).
168        - LSCP doc: Be more clear describing the two distinct approaches
169          of using external vs. internal effects (see bug #169).
170        - "optional" class: Fixed comparison operators.
171    
172      * Gigasampler/GigaStudio format engine:
173        - Format extension: If requested by instrument then don't play release
174          trigger sample on note-off events.
175    
176      * SFZ format engine:
177        - Fixed memory leak when releasing samples
178          (fixes bug #307, patch by Jacek Roszkowski)
179        - Fixed potential crash when a sample is shared by more than one region
180          (fixes bug #308, patch by Jacek Roszkowski).
181        - Opcode 'sample': Added support for built-in sample '*silence'
182          (fixes bug #310, patch by Jacek Roszkowski).
183    
184    Version 2.1.0 (25 Nov 2017)
185    
186    * SFZ format engine:    * SFZ format engine:
187      - added support for <global>, <master> and #define (patch by Alby M)      - added support for <global>, <master> and #define (patch by Alby M)
188        - Removed code duplication in SFZ file loading code.
189        - Added support for sfz extension opcode 'script' which may be used to
190          load real-time instrument script file (NKSP script language).
191        - Implemented opcode set_ccN (initial patch by Giovanni Senatore).
192        - Fixed unintended volume fade-in of voices under certain conditions.
193        - sfz parser: allow missing space between header and opcode
194    
195      * Gigasampler/GigaStudio format engine:
196        - Fixed clicks and pumping noise with Lowpass Turbo filter on very low
197          cutoff settings.
198        - Got rid of resembling an ancient GSt misbehavior which did not pitch at
199          all if an up-pitch of more than 40 semi tones was requested (I don't
200          think there is any stock gig sound that requires this behavior to
201          resemble its original sound).
202        - Added support for controlling whether the individual EGADSR stages may
203          be aborted (as LinuxSampler extension to the original GigaStudio 4
204          format).
205    
206    * general changes:    * general changes:
207      - fixed printf type errors (mostly in debug messages)      - fixed printf type errors (mostly in debug messages)
# Line 24  Version SVN trunk (?) Line 224  Version SVN trunk (?)
224        (CC #64) events.        (CC #64) events.
225      - Fix: Release trigger voices can now also distinguish correctly between      - Fix: Release trigger voices can now also distinguish correctly between
226        note-off and sustain pedal up events.        note-off and sustain pedal up events.
227        - All engines: Increased ramp speed of volume smoother and pan smoother
228          (while slow rate of crossfade smoother is preserved) to allow quick
229          volume and pan changes by instrument scripts for instance.
230        - gig/sf2/sfz: Fixed aftertouch channel pressure events being processed
231          properly and thus were ignored for certain uses.
232        - Added new C++ API method
233          VirtualMidiDevice::SendChannelPressureToSampler().
234        - windows, 32-bit: fixed potential crashes by making sure the stack in
235          sub threads is 16-byte aligned
236        - fixed numerous compiler warnings
237        - Fixed invalid (note-on) event ID being assigned to new Note objects.
238        - Revised fundamental C++ classes "Thread", "Mutex" and "Condition" which
239          fixes potential undefined behavior.
240        - Fixed Note object leak when triggering notes on keys which did not
241          have a valid sample mapped (fixes bug #252).
242        - Fixed compilation errors when compiling with CONFIG_DEVMODE enabled.
243        - linuxsampler binary fix: option --create-instruments-db ignored
244          subsequent optional argument due to glibc's implementation oddity
245          which expects a "=" sign, but no space between them.
246    
247    * packaging changes:    * packaging changes:
248      - removed unnecessary dependency to libuuid      - removed unnecessary dependency to libuuid
249        (originated by libgig's usage of it)        (originated by libgig's usage of it)
250      - Automake: set environment variable GCC_COLORS=auto to allow GCC to      - Automake: set environment variable GCC_COLORS=auto to allow GCC to
251        auto detect whether it (sh/c)ould output its messages in color.        auto detect whether it (sh/c)ould output its messages in color.
252        - Debian: Fixed packaging error about invalid "Source-Version"
253          substitution variable.
254        - Debian: Raised Debian compatibility level to Debian 9 "Stretch".
255        - Debian: Added build dependency to libsqlite3-dev for building
256          linuxsampler with instruments DB support.
257    
258    * Real-time instrument scripts:    * Real-time instrument scripts:
259      - Implemented scheduler for delayed MIDI events and for suspended scripts.      - Implemented scheduler for delayed MIDI events and for suspended scripts.
# Line 98  Version SVN trunk (?) Line 322  Version SVN trunk (?)
322      - Added built-in script constant "$NI_CB_TYPE_RELEASE".      - Added built-in script constant "$NI_CB_TYPE_RELEASE".
323      - Added built-in script constant "$NI_CB_TYPE_CONTROLLER".      - Added built-in script constant "$NI_CB_TYPE_CONTROLLER".
324      - NKSP Language: Added support for user defined script functions.      - NKSP Language: Added support for user defined script functions.
325        - Implemented built-in script function "change_attack()".
326        - Implemented built-in script function "change_decay()".
327        - Implemented built-in script function "change_release()".
328        - Fixed all change_*() built-in script functions to apply their
329          synthesis parameter changes immediately in case the respective note
330          was triggered at the same time, instead of scheduling the parameter
331          change, especially because it would cause some parameter types's
332          changes either to be ramped (i.e. change_vol()) or other types even
333          to have not effect at all (i.e. change_attack()).
334        - Implemented built-in script function "sh_left()".
335        - Implemented built-in script function "sh_right()".
336        - Implemented built-in script function "min()".
337        - Implemented built-in script function "max()".
338        - NKSP Fix: "init" event handler was not always executed when a script
339          was loaded.
340        - NKSP built-in wait() script function: abort script execution if
341          a negative or zero wait time was passed as argument (since this is
342          a common indication of a bug either of the script or even of the
343          engine, which could lead to RT instability or even worse).
344        - ScriptVM: Implemented automatic suspension of RT safety
345          threatening scripts.
346        - Provide more user friendly error messages on syntax errors.
347        - Fixed NKSP parser warning "Not a statement" when assigning an
348          initializer list to an array variable.
349        - Implemented built-in script array variable "%ALL_EVENTS".
350        - Implemented built-in script function "in_range()".
351        - Implemented built-in script function "change_amp_lfo_depth()".
352        - Implemented built-in script function "change_amp_lfo_freq()".
353        - Implemented built-in script function "change_pitch_lfo_depth()".
354        - Implemented built-in script function "change_pitch_lfo_freq()".
355        - Implemented built-in script function "change_vol_time()".
356        - Implemented built-in script function "change_tune_time()".
357        - Implemented built-in script function "fade_in()".
358        - Implemented built-in script function "fade_out()".
359        - Fixed acceptance of wrong data type of parameters passed to built-in
360          script functions "change_vol()", "change_tune()", "change_pan()",
361          "change_cutoff()", "change_reso()", "change_attack()", "change_decay()",
362          "change_release()", "change_amp_lfo_depth()", "change_amp_lfo_freq()",
363          "change_pitch_lfo_depth()" and "change_pitch_lfo_freq()".
364        - Added built-in script function "get_event_par()" and implemented some
365          of its possible parameter selections.
366        - Added built-in script function "set_event_par()" and implemented some
367          of its possible parameter selections.
368        - Fixed a bunch of scheduler time related bugs.
369        - Fixed polyphonic variables not being reset to zero after usage.
370        - Built-in "ignore_event()" function: argument is now optional, like with
371          built-in function "ignore_controller()".
372        - Implemented built-in script function "change_velo()".
373        - Implemented built-in script function "change_note()".
374        - Adjusted behavior of "change_vol()" and "change_tune()" to a more
375          intuitive behavior if used in combination with "change_vol_time()" or
376          "change_tune_time()" respectively: now tuning/volume changes are only
377          assigned (without delay) immediately to a new note if the respective
378          timing function has not been called before, otherwise the volume/tuning
379          changes are automatically faded (before, only the event's time stamp was
380          relevant).
381         - Implemented built-in script function "array_equal()".
382         - Implemented built-in script function "search()".
383         - Implemented built-in script function "sort()".
384         - NKSP Fix: Never suspend "init" event handlers.
385         - Implemented built-in script function "same_region()" (currently only
386           available for gig format engine).
387         - Added built-in script constant "$NKSP_LINEAR".
388         - Added built-in script constant "$NKSP_EASE_IN_EASE_OUT".
389         - Implemented built-in script function "change_vol_curve()".
390         - Implemented built-in script function "change_tune_curve()".
391         - built-in "play_note()" function now supports a sample playback start
392           offset with argument 3, where special value -1 means to use the regular
393           sample offset as defined by the instrument file.
394         - Built-in array variable %KEY_DOWN[] is now a read-only variable.
395         - Built-in variable $EVENT_NOTE is now a read-only variable.
396         - Built-in variable $EVENT_VELOCITY is now a read-only variable.
397         - built-in "play_note()" function now accepts -2 for its fourth argument
398           (note duration) which means the life time of the note shall be sticked
399           to the requested note number of argument 1.
400         - Fix: built-in "play_note()" function now returns 0 as result value if
401           -1 was passed for its fourth argument (note duration) and the respective
402           parent note is already gone.
403        - Implemented built-in script function "change_play_pos()".
404        - NKSP language: Added support for user declared const array variables.
405        - NKSP language: Raise parser warning if array variable is accessed with
406          an index that exceeds the array's size.
407        - NKSP language fix: Unknown characters were not handled correctly.
408        - NKSP language: Added support for "synchronized .. end synchronized"
409          code blocks.
410        - Implemented built-in script function "abort()" which allows to abort
411          another script handler by passing its callback ID.
412        - Fixed potential memory access bug and potential undefined behavior of
413          "init" event handlers.
414        - Print a time stamp along to each call of built-in function "message()".
415        - ScriptVM API: Added VMParserContext::preprocessorComments() which allows
416          to retrieve all code blocks filtered out by the preprocessor.
417        - Added built-in script function "fork()".
418        - Added built-in array variable %NKSP_CALLBACK_CHILD_ID[].
419        - Added built-in variable $NKSP_CALLBACK_PARENT_ID.
420        - Fixed potential crash when accessing dynamic built-in array variables.
421        - Added built-in script function "callback_status()".
422        - Added built-in constant $CALLBACK_STATUS_TERMINATED.
423        - Added built-in constant $CALLBACK_STATUS_QUEUE.
424        - Added built-in constant $CALLBACK_STATUS_RUNNING.
425        - Removed max. value limitation of built-in functions "change_attack()",
426          "change_decay()" and "change_release()" to i.e. allow passing 2000000
427          for doubling the respective time.
428        - NKSP script editor syntax highlighting API: Fixed app termination due
429          to a lexer start condition stack underrun.
430        - NKSP preprocessor: Fixed wrong behavior on nested USE_CODE_IF() and
431          USE_CODE_IF_NOT() preprocessor statements.
432        - NKSP: Added built-in preprocessor condition NKSP_NO_MESSAGE, which
433          can be set to disable all subsequent built-in "message()" function calls
434          on preprocessor level.
435        - Implemented built-in script function "change_sustain()".
436        - NKSP script editor syntax highlighting API: catch all fatal lexer errors,
437          to avoid the editor app to crash on ill-formed text input.
438        - Added built-in script function "change_pan_time()".
439        - Added built-in script function "change_pan_curve()".
440        - Added built-in script function "change_cutoff_attack()".
441        - Added built-in script function "change_cutoff_decay()".
442        - Added built-in script function "change_cutoff_sustain()".
443        - Added built-in script function "change_cutoff_release()".
444        - Added built-in script function "change_cutoff_lfo_depth()".
445        - Added built-in script function "change_cutoff_lfo_freq()".
446    
447      * Instruments DB:
448        - Fixed memory access bug of general DB access code which lead to
449          undefined behavior.
450        - Cleanup of instruments DB file creation and opening code.
451        - The instrument DB path of linuxsampler's --create-instruments-db argument
452          is now optional, if it is missing, then a default location is used.
453        - Added support for scanning SFZ (.sfz) files.
454        - Added support for scanning Sound Font (.sf2) files.
455        - Fixed undefined DB transaction behavior.
456    
457  Version 2.0.0 (15 July 2015)  Version 2.0.0 (15 July 2015)
458    
# Line 522  Version 2.0.0 (15 July 2015) Line 877  Version 2.0.0 (15 July 2015)
877        "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"        "SUBSCRIBE SEND_EFFECT_CHAIN_INFO"
878      - provide comprehensive error messages on LSCP syntax errors      - provide comprehensive error messages on LSCP syntax errors
879        (suggesting expected next non-terminal symbols)        (suggesting expected next non-terminal symbols)
880        - Fixed client connection not being closed after network errors.
881    
882    * LSCP shell:    * LSCP shell:
883      - Added support for auto correction of obvious and trivial syntax mistakes.      - Added support for auto correction of obvious and trivial syntax mistakes.
# Line 571  Version 2.0.0 (15 July 2015) Line 927  Version 2.0.0 (15 July 2015)
927        $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.        $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.
928      - Giga format scripts: Implemented built-in script function      - Giga format scripts: Implemented built-in script function
929        "gig_set_dim_zone(event_id, dimension, zone)".        "gig_set_dim_zone(event_id, dimension, zone)".
930      - Implemented built-in script int array variable $KEY_DOWN.      - Implemented built-in script int array variable %KEY_DOWN.
931      - Implemented built-in script function "abs()".      - Implemented built-in script function "abs()".
932      - Implemented built-in script function "random()".      - Implemented built-in script function "random()".
933      - Implemented built-in script function "num_elements()".      - Implemented built-in script function "num_elements()".
# Line 585  Version 2.0.0 (15 July 2015) Line 941  Version 2.0.0 (15 July 2015)
941        (i.e. return value of new script function "by_marks()").        (i.e. return value of new script function "by_marks()").
942      - Pass/preserve polyphonic variable data from respective "note" event      - Pass/preserve polyphonic variable data from respective "note" event
943        handler to "release" event handler.        handler to "release" event handler.
944        - Fixed crash when using built-in script function "by_marks()".
945    
946    * Bug fixes:    * Bug fixes:
947      - 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.2951  
changed lines
  Added in v.3584
  ViewVC Help
Powered by ViewVC