--- doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html 2015/04/26 20:54:00 2732 +++ doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html 2016/07/14 00:44:04 2946 @@ -28,7 +28,15 @@
message()
dec()
inc()
message()
change_pan()
change_tune()
change_vol()
change_cutoff()
change_reso()
event_status()
set_controller()
+ Most fundamental NKSP built-in variables, independent from any purpose of + being used in a sampler. +
+Variable | Description | +
---|---|
$KSP_TIMER |
+ Preserved for compatiblity reasons with KSP, returns the same value
+ as $NKSP_REAL_TIMER (refer to the latter for details).
+ Note that KSP's reset_ksp_timer() function is not available with
+ NKSP. However when calculating time differences between two time
+ stamps taken with $NKSP_REAL_TIMER , calling such a reset
+ function is not required, because the underlying clock does not stop
+ when it reached its value limit (which happens every 71 minutes), instead the clock
+ will automatically restart from zero and the calculated time difference
+ even between such transitions will reflect correct durations. |
+
$NKSP_PERF_TIMER |
+ Returns the current performance time stamp (in microseconds) of the
+ script running. You may read this variable from time to time to take
+ time stamps which can be used to calculate the time difference
+ (in microseconds) which elapsed between them. A performance time
+ stamp is based on the script's actual CPU execution time. So the
+ internal clock which is used for generating such time stamps is only
+ running forward if the respective script is actually executed by the
+ CPU. Whenever your script is not really executed by the CPU (i.e. because
+ your script got suspended by a wait() call or got forcely suspended due to
+ real-time constraints, or when the entire sampler application got suspended
+ by the OS for other applications or OS tasks) then the underlying internal
+ clock is paused as well.
+ $ENGINE_UPTIME instead, which is
+ also safe for offline bounces.
+ $NKSP_REAL_TIMER and
+ $NKSP_PERF_TIMER will actually return the same value. So the
+ difference between them is not implemented for all systems at the moment.
+ |
+
$NKSP_REAL_TIMER |
+ Returns the current time stamp in reality (in microseconds). You may
+ read this variable from time to time to take
+ time stamps which can be used to calculate the time difference
+ (in microseconds) which elapsed between them. A "real" time
+ stamp is based on an internal clock which constantly proceeds, so this
+ internal clock also continues counting while your script is either suspended
+ (i.e. because your script got suspended by a wait() call or got forcely
+ suspended due to real-time constraints) and it also continues counting
+ even if the entire sampler application got suspended by the OS (i.e. to
+ execute other applications for multi-tasking or to perform OS tasks).
+ $ENGINE_UPTIME instead, which is
+ also safe for offline bounces.
+ $NKSP_REAL_TIMER and
+ $NKSP_PERF_TIMER will actually return the same value. So the
+ difference between them is not implemented for all systems at the moment.
+ |
+
Basic sampler related built-in variables and constants, independent from a
@@ -160,10 +277,22 @@
note
or release
handler).
$EVENT_STATUS_INACTIVE
event_status()
in case the requested
+ note is not "alive".$EVENT_STATUS_NOTE_QUEUE
event_status()
in case the requested
+ note is still "alive".%KEY_DOWN[]
event_status()
).
$VCC_MONO_AT
%CC[$VCC_PITCH_BEND]
to obtain the current aftertouch value
+ %CC[$VCC_PITCH_BEND]
to obtain the current pitch bend wheel value
in the context of a controller
event handler.
set_event_mark()
for details.$ENGINE_UPTIME