gig_set_dim_zone()
Overrides and selects another active zone of a particular GigaStudio dimension. Usually each dimension is assigned to some MIDI controller, or to note-on velocity or other sources, and by changing the respective MIDI controller or velocity or the respective source, the respective dimension zone is selected accordingly. With this function you have an alternative to change the currently active dimension zone(s) programmatically at any time.
Function Prototype
gig_set_dim_zone(events, dimension, zone)
Arguments
Argument Name | Data Type | Description |
---|---|---|
events |
Event Group ID Number or Event Group ID Array | Note on event ID(s) of the note(s) where the current dimension zone
shall be changed. [required] |
dimension |
Dimension ID Number | The dimension that shall be changed. You should pass one of the
built-in constants (listed below) to select one of the available
dimension types. [required] |
zone |
Integer Number | The zone index of the dimension that shall become active. [required] |
Return Value
None.
Dimension Constants
You should use one of the following built-in constants for the
dimension
argument:
$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
Examples
None yet.
Availability
Since LinuxSampler 2.0.0.
Furthermore this function exists only with NKSP, it is not available with KSP.
Document Updated: 2019-09-18 | Author: Christian Schoenebeck