/[svn]/linuxsampler/trunk/src/scriptvm/CoreVMFunctions.h
ViewVC logotype

Log of /linuxsampler/trunk/src/scriptvm/CoreVMFunctions.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 (5 months, 4 weeks ago) by schoenebeck
File length: 23072 byte(s)
Diff to previous 3577
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 (6 months ago) by schoenebeck
File length: 15213 byte(s)
Diff to previous 3573
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 3573 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Tue Aug 27 21:36:53 2019 UTC (6 months ago) by schoenebeck
File length: 14311 byte(s)
Diff to previous 3564
NKSP: Introducing floating point support.

* NKSP language: Added support for NKSP real number literals and
  arithmetic operations on them (e.g. "(3.9 + 2.9) / 12.3 - 42.0").

* NKSP language: Added support for NKSP real number (floating point)
  script variables (declare ~foo := 3.4).

* NKSP language: Added support for NKSP real number (floating point)
  array script variables (declare ?foo[3] := ( 1.1, 2.7, 49.0 )).

* NKSP built-in script function "message()" accepts now real number
  argument as well.

* Added built-in NKSP script function "real_to_int()" and its short
  hand form "int()" for casting from real number to integer in NKSP
  scripts.

* Added built-in NKSP script function "int_to_real()" and its short
  hand form "real()" for casting from integer to real number in NKSP
  scripts.

* Bumped version (2.1.1.svn6).


Revision 3564 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Sat Aug 24 09:18:57 2019 UTC (6 months ago) by schoenebeck
File length: 11787 byte(s)
Diff to previous 3561
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 (6 months ago) by schoenebeck
File length: 11771 byte(s)
Diff to previous 3557
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 (6 months, 1 week ago) by schoenebeck
File length: 11436 byte(s)
Diff to previous 3551
* 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 3551 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Aug 1 10:22:56 2019 UTC (6 months, 4 weeks ago) by schoenebeck
File length: 10577 byte(s)
Diff to previous 3221
* Added test cases for NKSP core language aspects and core built-in
  functions.
* NKSP: Added method ScriptVM::setExitResultEnabled() which allows
  to explicitly enable the built-in exit() function to optionally
  accept one function argument; the value of the passed exit()
  function argument will then become available by calling
  VMExecContext::exitResult() after script execution.
* Bumped version (2.1.1.svn2).


Revision 3221 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri May 26 18:30:42 2017 UTC (2 years, 9 months ago) by schoenebeck
File length: 10505 byte(s)
Diff to previous 3076
* NKSP Fix: Never suspend "init" event handlers.
* NKSP: Implemented built-in script function "array_equal()".
* NKSP: Implemented built-in script function "search()".
* NKSP: Implemented built-in script function "sort()".
* Bumped version (2.0.0.svn52).


Revision 3076 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jan 5 18:00:52 2017 UTC (3 years, 1 month ago) by schoenebeck
File length: 9305 byte(s)
Diff to previous 3054
* NKSP: Implemented built-in script function "in_range()".
* Bumped version (2.0.0.svn36).


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


Revision 3034 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Oct 31 00:05:00 2016 UTC (3 years, 3 months ago) by schoenebeck
File length: 8786 byte(s)
Diff to previous 2970
* Fixed a bunch of minor issues (mostly compiler warnings).
* Bumped version (2.0.0.svn31).


Revision 2970 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jul 21 16:22:55 2016 UTC (3 years, 7 months ago) by schoenebeck
File length: 8667 byte(s)
Diff to previous 2965
* NKSP: Implemented built-in script function "min()".
* NKSP: Implemented built-in script function "max()".
* Bumped version (2.0.0.svn23).


Revision 2965 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Mon Jul 18 09:42:28 2016 UTC (3 years, 7 months ago) by schoenebeck
File length: 7865 byte(s)
Diff to previous 2945
* NKSP: Implemented built-in script function "sh_left()".
* NKSP: Implemented built-in script function "sh_right()".
* Bumped version (2.0.0.svn22).


Revision 2945 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Thu Jul 14 00:22:26 2016 UTC (3 years, 7 months ago) by schoenebeck
File length: 7045 byte(s)
Diff to previous 2727
* 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 2727 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Tue Mar 31 17:46:11 2015 UTC (4 years, 11 months ago) by schoenebeck
File length: 5775 byte(s)
Diff to previous 2619
- Just added API doc comments to Script VM code.


Revision 2619 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Wed Jun 11 13:24:32 2014 UTC (5 years, 8 months ago) by schoenebeck
File length: 4035 byte(s)
Diff to previous 2598
* Implemented built-in instrument script function "abs()".
* Implemented built-in instrument script function "random()".
* Implemented built-in instrument script function "num_elements()".
* Disabled debug mode of RefPtr template class.
* Bumped version (1.0.0.svn51).


Revision 2598 - (view) (download) (as text) (annotate) - [select for diffs]
Modified Fri Jun 6 12:38:54 2014 UTC (5 years, 8 months ago) by schoenebeck
File length: 3074 byte(s)
Diff to previous 2596
* 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]
Modified Thu Jun 5 19:39:12 2014 UTC (5 years, 8 months ago) by schoenebeck
File length: 2638 byte(s)
Diff to previous 2581
* 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).


Revision 2581 - (view) (download) (as text) (annotate) - [select for diffs]
Added Fri May 30 12:48:05 2014 UTC (5 years, 9 months ago) by schoenebeck
File length: 2566 byte(s)
* (WIP) Implemented parser and VM for upcoming new real-time instrument
  script support. It needs yet to be integrated into the sampler's
  sampler engines. You can toy around for now with the command line tool
  "ls_instr_script" and i.e. examples showing the core language features
  under src/scriptvm/examples/.
* Bumped version (1.0.0.svn41).


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