--- doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html 2017/05/19 14:26:05 3189 +++ doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html 2017/06/27 23:40:50 3295 @@ -15,7 +15,7 @@

Built-In Functions

- These are the built-in functions available with the NKSP realt-time + These are the built-in functions available with the NKSP real-time instrument script language.

@@ -28,6 +28,18 @@ Function Description + abort() + Stops execution of a script callback. + + + array_equal() + Check whether two arrays are equal. + + + fork() + Creates new execution instances (threads). + + dec() Decrements the passed integer variable by one. @@ -44,6 +56,14 @@ Prints text to the sampler's terminal. + search() + Search for a certain value within an array. + + + sort() + Sort the given array. + + exit() Stops execution of the current event handler instance. @@ -99,10 +119,18 @@ Triggers a new note. + change_note() + Change MIDI note number of note. + + change_pan() Changes panning of voices (stereo balance). + change_play_pos() + Change the sample playback position. + + change_tune() Changes the tuning of voices. @@ -111,6 +139,10 @@ Changes the duration of tuning changes. + change_tune_curve() + Changes the curve type of tuning changes. + + change_vol() Changes the volume of voices. @@ -119,6 +151,10 @@ Changes the duration of volume changes. + change_vol_curve() + Changes the curve type of volume changes. + + change_cutoff() Changes filter cutoff frequency of voices. @@ -155,6 +191,10 @@ Modifies the pitch LFO frequency. + change_velo() + Change MIDI velocity of note. + + event_status() Checks and returns whether a particular note is still alive. @@ -167,6 +207,14 @@ Fade the requested note out. + get_event_par() + Get the current value of a specific note parameter. + + + set_event_par() + Change the value of a specific note parameter. + + set_controller() Creates a MIDI control change event. @@ -209,6 +257,10 @@ gig_set_dim_zone() Changes the currently active dimension zone. + + same_region() + Check whether two keys are mapped to the same region. +

Built-In Variables

@@ -271,6 +323,23 @@ + %NKSP_CALLBACK_CHILD_ID[] + + Reflects the callback IDs of all child threads which the current + script callback instance spawned by having called fork() before. + See the latter function for details about this array variable. + + + + $NKSP_CALLBACK_PARENT_ID + + If the current execution thread is a child thread spawned by a fork() + call before, then this variable reflects the callback ID of the parent + thread which created this child thread. Otherwise this variable is 0. + See fork() for more details about this variable. + + + $NKSP_REAL_TIMER Returns the current time stamp in reality (in microseconds). You may read this variable from time to time to take @@ -412,12 +481,51 @@ note is still "alive". + $EVENT_PAR_NOTE + Constant value symbolizing the "note number" parameter. See + get_event_par() and set_event_par() + for details. + + + $EVENT_PAR_TUNE + Constant value symbolizing the "tune" parameter. See + get_event_par() and set_event_par() + for details. + + + $EVENT_PAR_VELOCITY + Constant value symbolizing the "note velocity" parameter. See + get_event_par() and set_event_par() + for details. + + + $EVENT_PAR_VOLUME + Constant value symbolizing the "volume" parameter. See + get_event_par() and set_event_par() + for details. + + + $EVENT_PAR_0 to $EVENT_PAR_3 + Four constant values symbolizing the 4 possible user specific + parameters, which i.e. might be used to pass data from one script + (slot) to another script (slot). See get_event_par() + and set_event_par() for details. + + %KEY_DOWN[] This can be used in any context to check whether a certain MIDI key is currently pressed down. Use the respective MIDI note number as index to this array variable (see also event_status()). + $NKSP_EASE_IN_EASE_OUT + Used to select a fade curve with "ease in and ease out" shape. + + + $NKSP_LINEAR + Used to select a fade curve with linear shape. + + $VCC_MONO_AT Constant identifying the MIDI monophonic aftertouch controller (also called @@ -491,7 +599,7 @@ Constant that identifies the keyboard position dimension. - $GIG_DIM_ROUNDROBIN" + $GIG_DIM_ROUNDROBIN Constant that identifies the round robin dimension.