/[svn]/linuxsampler/trunk/src/engines/common/InstrumentScriptVMFunctions.h
ViewVC logotype

Log of /linuxsampler/trunk/src/engines/common/InstrumentScriptVMFunctions.h

Parent Directory Parent Directory | Revision Log Revision Log


Links to HEAD: (view) (download) (as text) (annotate)
Sticky Revision:

Revision 3581 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Aug 30 11:40:25 2019 UTC (4 years, 6 months ago) by schoenebeck
File length: 27802 byte(s)
Diff to previous 3577 , to selected 3296
NKSP: Allow more wider support of standard measuring units & 'final'ness.

* Raised compiler requirement to be C++14 compliant (due to severe
  restrictions regarding C-style aggregate initializer lists in C++11
  which are now massively used throughout the code base).

* NKSP VM API: Allow units and 'final'ness to be returned as result from
  built-in functions (added methods VMFunction::returnUnitType() and
  VMFunction::returnsFinal() for that purpose which must be implemented by
  built-in function implementations).

* NKSP language: Allow metric unit prefixes of numeric scalar and array
  variables to be changed freely at runtime (unlike unit types like Hz etc.
  which are still sticky parse-time features of variables which cannot be
  changed at runtime for the intentional sake of determinism).

* NKSP language: 'final' values are prohibited for array variables for now
  (attempt causes a parsers error).

* NKSP language: expressions with unit types (e.g. Hz) are prohibited for
  conditions of runtime control structures like if(), while(), select()
  (attempt causes a parser error).

* NKSP VM API: Allow built-in functions to perform their own, individual
  parse time checks of arguments going to be passed to the function at
  runtime (added method VMFunction::checkArgs() for that purpose).

* NKSP language: raise parser warning if only one operand of binary
  operators (like logical 'or' comparison) contain a 'final' value (because
  it would always yield in a 'final' result in such cases).

* NKSP language: Allow comparison (=, #, <, >, <=, >=) of values with
  different metric unit prefixes, which will behave as expected (e.g.
  result of expression '1000us < 2ms' is true).

* NKSP language: Allow adding values with different metric unit prefixes
  (e.g. result of expression '100Hz + 5kHz' is '5100Hz').

* NKSP language: Allow subtracting values with different metric unit
  prefixes (e.g. result of expression '1ms - 20us' is '980us').

* NKSP language: Allow multiplying with any metric unit prefixes
  (e.g. result of expression '2k * 3ms' is '6s'), however multiplications
  with unit types on both sides (e.g. '2s * 2s') is still prohibited since
  we don't have any considerable practical use for a term like '4s^2'
  (hence any attempt multiplying two unit types still causes parser error).

* NKSP language: Allow dividing by any metric unit prefixes and allow
  division of same unit type on both sides (e.g. expression '8kHz / 1000Hz'
  yields in unit free result '8'). So this is now a way to cast units away
  e.g. for passing the result to other expressions, certain function calls
  or variables which are not accepting any units (or that specific unit).

* NKSP language: integer arrays and real number arrays can now be converted
  to strings (e.g. for dumping their content with message() calls for
  script debugging purposes).

* NKSP language: expressions and variables with units are now correctly
  casted to strings (e.g. with message() calls).

* NKSP language: comparing real numbers for equalness (e.g. '~foo = 3.1') or
  unequalness (e.g. '~foo # 3.1') is now less strict and takes the expected
  floating point tolerances into account.

* NKSP VM API: Added methods VMScalarNumberExpr::evalCastInt() and
  VMScalarNumberExpr::evalCastReal().

* NKSP VM API: Added base class 'VMNumberArrayExpr' for classes
  'VMIntArrayExpr' and 'VMRealArrayExpr'.

* NKSP VM API: replaced all unitPrefix() (parse time) methods by
  unitFactor() (runtime) methods.

* Built-in function "exit()" supports now returning units and 'final'ness
  exclusively for test cases.

* The following built-in functions support now units as well: "abs()",
  "random()", "inc()", "dec()", "in_range()", "min()", "max()",
  "real_to_int()", "int()", "int_to_real()" and "real()".

* Built-in functions "array_equal()", "search()" and "sort()" support now
  real number arrays (correctly) as well.

* Added individual parse time checks of arguments to be passed to built-in
  functions "random()", "inc()", "dec()", "in_range()", "min()", "max()",
  "array_equal()" and "search()" specific for their individual purposes.

* Test cases: Added massive amount of NKSP test cases for standard
  measuring units and 'final' operator usage cases.

* Test cases: Added NKSP test cases for (floating point tolerance aware)
  real number equalness / unequalness comparison.

* Bumped version (2.1.1.svn8).


Revision 3577 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Wed Aug 28 15:23:23 2019 UTC (4 years, 7 months ago) by schoenebeck
File length: 26286 byte(s)
Diff to previous 3564 , to selected 3296
NKSP: Introducing variable return type for built-in functions.

* Changed method signature VMFunction::returnType() ->
  VMFunction::returnType(VMFnArgs* args) to allow built-in
  functions to proclaim a different result value type depending
  on the arguments to be passed to the function.

* Built-in script function abs() optionally accepts and returns
  real number.

* Built-in script functions min() and max() optionally accept
  real number arguments and return real number as result in that
  case.

* Added real number test cases for the built-in abs(), min() and
  max() functions.

* Bumped version (2.1.1.svn7).


Revision 3564 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Aug 24 09:18:57 2019 UTC (4 years, 7 months ago) by schoenebeck
File length: 26272 byte(s)
Diff to previous 3561 , to selected 3296
NKSP: Bug fixes regarding new measurement units feature:

* Fix: Engine internal Fade of script synthesis parameters volume, pitch
  and pan were not rendered at all.

* Fix: Backward compatibility of built-in function arguments without a
  metric unit prefix was broken (resulted in incorrect value
  transformation).

* Fix: built-in script function change_play_pos() resolved wrong arguments.

* Bumped version (2.1.1.svn5).


Revision 3561 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Aug 23 11:44:00 2019 UTC (4 years, 7 months ago) by schoenebeck
File length: 25939 byte(s)
Diff to previous 3557 , to selected 3296
NKSP: Added standard units support for numbers and final "!" operator:

* NKSP strictness: Variable names, function names and preprocessor condition
  names must start with a regular character (a-z or A-Z); starting them with
  a digit or underscore is no longer allowed.

* NKSP parser fix: equal comparison operator "=" and not equal comparison
  operator "#" must only accept integer operands.

* NKSP language: Implemented support for standard units like Hertz, seconds,
  Bel including support for metric unit prefixes; so one can now e.g.
  conveniently use numbers in scripts like "5us" meaning "5 microseconds",
  or e.g. "12kHz" meaning "12 kilo Hertz", or e.g. "-14mdB" meaning
  "minus 14 Millidecibel", or e.g. "28c" meaning "28 cents" (for tuning).

* NKSP language: Introduced "final" operator "!" which is specifically
  intended for synthesis parameter values to denote that the synthesis
  parameter value is intended to be the "final" value for that synthesis
  parameter that should explicitly be used by the engine and thus causing
  the sampler engine to ignore all other modulation sources for the same
  synthesis parameter (like e.g. LFO, EG); by simply prefixing a value,
  variable or formula with this new "!" operator the expression is marked as
  being "final".

* Bumped version (2.1.1.svn4).


Revision 3557 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sun Aug 18 00:06:04 2019 UTC (4 years, 7 months ago) by schoenebeck
File length: 23569 byte(s)
Diff to previous 3455 , to selected 3296
* NKSP: Introducing 64 bit support for NKSP integer scripts
  variables (declare $foo).
* Require C++11 compiler support.
* Autoconf: Added m4/ax_cxx_compile_stdcxx.m4 macro which is used
  for checking in configure for C++11 support (as mandatory
  requirement) and automatically adds compiler argument if required
  (e.g. -std=C++11).
* Bumped version (2.1.1.svn3).


Revision 3455 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sun Jan 27 10:07:54 2019 UTC (5 years, 2 months ago) by persson
File length: 21905 byte(s)
Diff to previous 3360 , to selected 3296
* Fixed some compiler warnings
* Fixed compilation error when cross-compiling to Mac


Revision 3360 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Oct 27 21:19:18 2017 UTC (6 years, 5 months ago) by schoenebeck
File length: 21869 byte(s)
Diff to previous 3335 , to selected 3296
* NKSP: Added built-in script function "change_cutoff_attack()".
* NKSP: Added built-in script function "change_cutoff_decay()".
* NKSP: Added built-in script function "change_cutoff_sustain()".
* NKSP: Added built-in script function "change_cutoff_release()".
* NKSP: Added built-in script function "change_cutoff_lfo_depth()".
* NKSP: Added built-in script function "change_cutoff_lfo_freq()".
* Bumped version (2.0.0.svn77).


Revision 3335 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sun Jul 30 14:33:15 2017 UTC (6 years, 8 months ago) by schoenebeck
File length: 20165 byte(s)
Diff to previous 3316 , to selected 3296
* NKSP: Added built-in script function "change_pan_time()".
* NKSP: Added built-in script function "change_pan_curve()".
* Bumped version (2.0.0.svn75).


Revision 3316 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jul 20 12:05:53 2017 UTC (6 years, 8 months ago) by schoenebeck
File length: 19621 byte(s)
Diff to previous 3296
* NKSP: Implemented built-in script function "change_sustain()".
* Bumped version (2.0.0.svn72).


Revision 3296 - (view) (download) (as text) (annotate) - [selected]
Modified Wed Jun 28 09:45:56 2017 UTC (6 years, 9 months ago) by schoenebeck
File length: 19351 byte(s)
Diff to previous 3293
* Added built-in script function "callback_status()".
* Added built-in constant $CALLBACK_STATUS_TERMINATED.
* Added built-in constant $CALLBACK_STATUS_QUEUE.
* Added built-in constant $CALLBACK_STATUS_RUNNING.
* Bumped version (2.0.0.svn66).


Revision 3293 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Tue Jun 27 22:19:19 2017 UTC (6 years, 9 months ago) by schoenebeck
File length: 18824 byte(s)
Diff to previous 3277 , to selected 3296
* NKSP: Added built-in script function "fork()".
* NKSP: Added built-in array variable %NKSP_CALLBACK_CHILD_ID[].
* NKSP: Added built-in variable $NKSP_CALLBACK_PARENT_ID.
* NKSP: Fixed potential crash when accessing dynamic built-in
  array variables.
* Bumped version (2.0.0.svn65).


Revision 3277 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Jun 5 18:40:18 2017 UTC (6 years, 9 months ago) by schoenebeck
File length: 18319 byte(s)
Diff to previous 3255 , to selected 3296
* NKSP: Implemented built-in script function "abort()" which allows
  to abort another script handler by passing its callback ID.
* Bumped version (2.0.0.svn61).


Revision 3255 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Tue May 30 15:43:39 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 17800 byte(s)
Diff to previous 3246 , to selected 3296
* NKSP: Implemented built-in script function "change_play_pos()".
* Bumped version (2.0.0.svn57).


Revision 3246 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sun May 28 22:22:56 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 17270 byte(s)
Diff to previous 3214 , to selected 3296
* NKSP: Implemented built-in script function "change_vol_curve()".
* NKSP: Implemented built-in script function "change_tune_curve()".
* NKSP: Added built-in script constant "$NKSP_LINEAR".
* NKSP: Added built-in script constant "$NKSP_EASE_IN_EASE_OUT".
* Bumped version (2.0.0.svn54).


Revision 3214 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu May 25 14:46:47 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 16121 byte(s)
Diff to previous 3212 , to selected 3296
* NKSP: Implemented built-in script function "change_velo()".
* NKSP: Implemented built-in script function "change_note()".
* Bumped version (2.0.0.svn49).


Revision 3212 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu May 25 13:17:47 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 15079 byte(s)
Diff to previous 3193 , to selected 3296
* NKSP: Built-in "ignore_event()" function: argument is now optional,
  like with built-in function "ignore_controller()".


Revision 3193 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat May 20 12:28:57 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 15079 byte(s)
Diff to previous 3188 , to selected 3296
* NKSP: Added built-in script function "get_event_par()" and implemented
  some of its possible parameter selections.
* NKSP: Added built-in script function "set_event_par()" and implemented
  some of its possible parameter selections.
* NKSP: Fixed (removed) artificial value limit for duration argument of
  built-in script functions "change_vol_time()" and "change_tune_time()".
* Fixed compile error with pre-C++11 compilers.
* Bumped version (2.0.0.svn46).


Revision 3188 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri May 19 14:23:12 2017 UTC (6 years, 10 months ago) by schoenebeck
File length: 14062 byte(s)
Diff to previous 3118 , to selected 3296
* NKSP: Implemented built-in script function "change_vol_time()".
* NKSP: Implemented built-in script function "change_tune_time()".
* NKSP: Implemented built-in script function "fade_in()".
* NKSP: Implemented built-in script function "fade_out()".
* NKSP: Fixed acceptance of wrong data type of parameters passed to
  built-in script functions "change_vol()", "change_tune()",
  "change_pan()", "change_cutoff()", "change_reso()",
  "change_attack()", "change_decay()", "change_release()",
  "change_amp_lfo_depth()", "change_amp_lfo_freq()",
  "change_pitch_lfo_depth()" and "change_pitch_lfo_freq()".
* Bumped version (2.0.0.svn45).


Revision 3118 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Apr 21 13:33:03 2017 UTC (6 years, 11 months ago) by schoenebeck
File length: 12436 byte(s)
Diff to previous 3054 , to selected 3296
* NKSP: Fixed crash when using built-in script array variable "%ALL_EVENTS".
* NKSP: Added built-in function "change_amp_lfo_depth()".
* NKSP: Added built-in function "change_amp_lfo_freq()".
* NKSP: Added built-in function "change_pitch_lfo_depth()".
* NKSP: Added built-in function "change_pitch_lfo_freq()".
* Bumped version (2.0.0.svn44).


Revision 3054 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Dec 15 12:47:45 2016 UTC (7 years, 3 months ago) by schoenebeck
File length: 10688 byte(s)
Diff to previous 2953 , to selected 3296
* Fixed numerous compiler warnings.
* Bumped version (2.0.0.svn32).


Revision 2953 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Jul 16 11:24:39 2016 UTC (7 years, 8 months ago) by schoenebeck
File length: 10625 byte(s)
Diff to previous 2948 , to selected 3296
* NKSP: Implemented built-in script function "change_attack()".
* NKSP: Implemented built-in script function "change_decay()".
* NKSP: Implemented built-in script function "change_release()".
* Bumped version (2.0.0.svn19).


Revision 2948 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Jul 15 15:29:04 2016 UTC (7 years, 8 months ago) by schoenebeck
File length: 9123 byte(s)
Diff to previous 2945 , to selected 3296
* NKSP: Implemented built-in script function "stop_wait()".
* NKSP: Implemented built-in script variable "$NI_CALLBACK_ID".
* NKSP: Implemented built-in script variable "$NI_CALLBACK_TYPE".
* NKSP: Implemented built-in script variable "$NKSP_IGNORE_WAIT".
* NKSP: Added support for read-only built-in variables
  (respectively handled by the script parser).
* NKSP: Added built-in script constant "$NI_CB_TYPE_INIT".
* NKSP: Added built-in script constant "$NI_CB_TYPE_NOTE".
* NKSP: Added built-in script constant "$NI_CB_TYPE_RELEASE".
* NKSP: Added built-in script constant "$NI_CB_TYPE_CONTROLLER".
* Bumped version (2.0.0.svn17).


Revision 2945 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jul 14 00:22:26 2016 UTC (7 years, 8 months ago) by schoenebeck
File length: 8358 byte(s)
Diff to previous 2935 , to selected 3296
* NKSP: Implemented built-in script function "inc()".
* NKSP: Implemented built-in script function "dec()".
* NKSP language fix: division expressions were evaluated too often.
* NKSP language fix: string concatenation operator was right
  associative instead of left (to right).
* Bumped version (2.0.0.svn15).


Revision 2935 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sun Jul 10 14:24:13 2016 UTC (7 years, 8 months ago) by schoenebeck
File length: 8226 byte(s)
Diff to previous 2931 , to selected 3296
* NKSP: Added & implemented built-in script function "change_cutoff()".
* NKSP: Added & implemented built-in script function "change_reso()".
* NKSP: Added & implemented built-in script function "event_status()".
* NKSP: Added built-in script constants "$EVENT_STATUS_INACTIVE" and
  "$EVENT_STATUS_NOTE_QUEUE" both for being used as flags for
  built-in "event_status()" script function.
* NKSP language: Added support for bitwise operators ".or.", ".and."
  and ".not.".
* NKSP language scanner: Fixed IDs matching to require at least one
  character (i.e. when matching function names or variable names).
* NKSP language scanner: disabled unusued rules.
* Bumped version (2.0.0.svn12).


Revision 2931 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Jul 9 14:38:33 2016 UTC (7 years, 8 months ago) by schoenebeck
File length: 6713 byte(s)
Diff to previous 2630 , to selected 3296
* Implemented built-in instrument script function "change_vol()".
* Implemented built-in instrument script function "change_tune()".
* Implemented built-in instrument script function "change_pan()".
* Bumped version (2.0.0.svn11).


Revision 2630 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Jun 13 15:01:06 2014 UTC (9 years, 9 months ago) by schoenebeck
File length: 5228 byte(s)
Diff to previous 2629 , to selected 3296
* Implemented built-in instrument script function "set_event_mark()".
* Implemented built-in instrument script function "delete_event_mark()".
* Implemented built-in instrument script function "by_marks()".
* Added built-in instrument script int const variables $MARK_1 to $MARK_28.
* Built-in instrument script functions "ignore_event()", "note_off()" and
  "gig_set_dim_zone()" now also accept an array of event IDs as argument
  (i.e. return value of new script function "by_marks()").
* Bumped version (1.0.0.svn53).


Revision 2629 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jun 12 18:25:11 2014 UTC (9 years, 9 months ago) by schoenebeck
File length: 3079 byte(s)
Diff to previous 2600 , to selected 3296
* Implemented built-in instrument script function "note_off()".
* Bumped version (1.0.0.svn52).


Revision 2600 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Jun 7 00:16:03 2014 UTC (9 years, 9 months ago) by schoenebeck
File length: 2564 byte(s)
Diff to previous 2598 , to selected 3296
* Implemented built-in instrument script function "set_controller()".
* Fixed built-in script functions "ignore_event()" and
  "ignore_controller()".
* Added extended instrument script VM for the Gigasampler/GigaStudio format
  sampler engine, which extends the general instrument script VM with Giga
  format specific variables and functions.
* Giga format instrument scripts: added built-in script int constant
  variables $GIG_DIM_CHANNEL, $GIG_DIM_LAYER, $GIG_DIM_VELOCITY,
  $GIG_DIM_AFTERTOUCH, $GIG_DIM_RELEASE, $GIG_DIM_KEYBOARD,
  $GIG_DIM_ROUNDROBIN, $GIG_DIM_RANDOM, $GIG_DIM_SMARTMIDI,
  $GIG_DIM_ROUNDROBINKEY, $GIG_DIM_MODWHEEL, $GIG_DIM_BREATH,
  $GIG_DIM_FOOT, $GIG_DIM_PORTAMENTOTIME, $GIG_DIM_EFFECT1,
  $GIG_DIM_EFFECT2, $GIG_DIM_GENPURPOSE1, $GIG_DIM_GENPURPOSE2,
  $GIG_DIM_GENPURPOSE3, $GIG_DIM_GENPURPOSE4, $GIG_DIM_SUSTAIN,
  $GIG_DIM_PORTAMENTO, $GIG_DIM_SOSTENUTO, $GIG_DIM_SOFT,
  $GIG_DIM_GENPURPOSE5, $GIG_DIM_GENPURPOSE6, $GIG_DIM_GENPURPOSE7,
  $GIG_DIM_GENPURPOSE8, $GIG_DIM_EFFECT1DEPTH, $GIG_DIM_EFFECT2DEPTH,
  $GIG_DIM_EFFECT3DEPTH, $GIG_DIM_EFFECT4DEPTH, $GIG_DIM_EFFECT5DEPTH.
* Giga format instrument scripts: Implemented built-in script function
  "gig_set_dim_zone(event_id, dimension, zone)", which allows to override
  dimension zone(s) for new voices.
* Bumped version (1.0.0.svn45).


Revision 2598 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Jun 6 12:38:54 2014 UTC (9 years, 9 months ago) by schoenebeck
File length: 2039 byte(s)
Diff to previous 2596 , to selected 3296
* ScriptVM (WIP): Built-in script function "play_note()" now returns the
  event ID of the triggered note.
* ScriptVM (WIP): Implemented built-in script int variable $EVENT_ID.
* ScriptVM (WIP): Implemented built-in script function "ignore_event()".
* ScriptVM (WIP): Implemented built-in script function
  "ignore_controller()" (accepts one and no argument).
* Bumped version (1.0.0.svn44).


Revision 2596 - (view) (download) (as text) (annotate) - [select for diffs]
Added Thu Jun 5 19:39:12 2014 UTC (9 years, 9 months ago) by schoenebeck
File length: 985 byte(s)
Diff to selected 3296
* ScriptVM (WIP): Implemented execution of script event
  handlers "note" and "release".
* ScriptVM (WIP): Implemented built-in script function
  "play_note()" (only two of the max. four function
  arguments are currently implemented yet though).
* ScriptVM (WIP): Fixed incorrect handling of
  suspended scripts.
* Bumped version (1.0.0.svn43).


This form allows you to request diffs between any two revisions of this file. For each of the two "sides" of the diff, enter a numeric revision.

  Diffs between and
  Type of Diff should be a

  ViewVC Help
Powered by ViewVC