Ksp reference Manual

Built-in Variables and Constants
160
KSP Reference Manual

---

$VCC_PITCH_BEND
The value of the virtual CC controller for pitch bend
%KEY_DOWN[]
Array which contains the current state of all keys. 1 if the key is held, 0 otherwise
%KEY_DOWN_OCT[]
1
if a note, independent of the octave, is held. 
0
otherwise. Due to this, the note number should be a value between 0 (C) and
11 (B).
17.3. Transport and Timing
$DISTANCE_BAR_START
Returns the time of a note on message in µsec from the beginning of the current bar with respect to the current tempo.
$DURATION_BAR
Returns the duration in µsec of one bar with respect to the current tempo.
This variable only works if the clock is running, otherwise it will return a value of zero.
You can also retrieve the duration of one bar by using 
$SIGNATURE_NUM
and 
$SIGNATURE_DENOM
in combination with
$DURATION_QUARTER
.
$DURATION_QUARTER
Duration of a quarter note in microseconds, with respect to the current tempo.
Also available:
$DURATION_EIGHTH
$DURATION_SIXTEENTH
$DURATION_QUARTER_TRIPLET
$DURATION_EIGHTH_TRIPLET
$DURATION_SIXTEENTH_TRIPLET
$ENGINE_UPTIME
Returns the time period in milliseconds (not microseconds) that has passed since the start of KONTAKT. The engine uptime
is calculated from the sample rate and can thus be used in ‘musical’ contexts, (eg. building arpeggiators or sequencers) as it
remains in sync, even in an offline bounce.
$KSP_TIMER
Returns the time period in microseconds that has passed since the start of KONTAKT.
Can be reset with 
reset_ksp_timer
.
The KSP timer is based on the CPU clock and thus runs at a constant rate, regardless of whether or not KONTAKT is being
used in real-time. As such, it should be used to test the efficiency of script and not to make musical calculations, as musical
calculations use the 
$ENGINE_UPTIME
timer.
$NI_SONG_POSITION
Returns the host’s current song position in 960 ticks per quarter note.