The Kyma Language for Sound Design, Version 4.5

For example,
!Volume is: `MIDIController07.
You could enter !Volume as the value of the Scale parameter in a Sample; the map would then associate
the Scale parameter with MIDI controller 7 data on the default MIDI channel (as specified in
Configure MIDI… under the DSP menu).
Event Values can be combinations of Event Sources and constants. For example,
!Pitch is: (`MIDIKeyNumber + (`MIDIPitchBend displayAs: #nothing)) nn.
Defines !Pitch to be the key number found in incoming MIDI note-on events offset by the incoming
value of the pitch bend wheel (which will not show up in the virtual control surface). In this example, the
pitch bend can contribute up to a half-step variation in the pitch. You can change the range of pitch bend
to an octave variation by using
!Pitch is: (`MIDIKeyNumber + (12 * `MIDIPitchBend)) nn.
in the global map.
When the global map is used to supply Event Values, Kyma uses the default MIDI channel number given
in Configure MIDI… under the DSP menu. A MIDIVoice or MIDIMapper Sound can override the default
MIDI channel for its input Sound by specifying the channel number in the Channel field.
Event Source Options
The Event Sources on the right side of each association in the map can have additional options controlling
MIDI channel, value scaling, and presentation in the virtual control surface.
You can override the default MIDI channel specification by adding a channel: tag to the specification of
the Event Source:
!Volume is: (`MIDIController07 channel: 5).
This tells Kyma that !Volume is associated with continuous controller number 7 on MIDI channel 5. Notice
that parentheses must enclose the Event Source whenever a tag is used.
You can specify how the Event Source should be scaled prior to being used as an Event Source:
!Volume is: (`MIDIController07 min: 0.5 max: 0.75).
Kyma will scale the normal (0,1) range of the MIDI continuous controller to the specified range of
(0.5,0.75).
You can also restrict the values to fall on a grid:
!Volume is: (`MIDIController07 min: 0.5 max: 0.75 grid: 0.05).
In this case, !Volume can only be one of the values 0.5, 0.55, 0.6, 0.65, 0.7, or 0.75.
You can specify whether changes in the Event Source result in linear or logarithmic changes in the Event
Value. By default, a change in the Event Source results in a linear change to the Event Value. To cause
logarithmic changes, use:
!Volume is: (`MIDIController07 taper: #log).
You can combine these options by separating them by semicolons, as in:
!Volume is: (`MIDIController07 channel: 5; min: 100 max: 1000 grid: 50; taper: #log).
Virtual Control Surface and Mappings
By defining the controller type in the map, you determine how controllers associated with Event Values
will appear in the virtual control surface. Controllers can be one of three types: faders, toggles, or gates.
Faders are commonly associated with continuous controllers. Toggles are typically used to switch from
one state to another (i.e., you can use a toggle to switch something on until you want to switch it off).
Gates are like momentary buttons; they are on for as long as they are held down, and they turn off as
soon as the button is released. (For example, the damper pedal is typically interpreted as a gate.)
483