The Kyma Language for Sound Design, Version 4.5

Event Sources are specified by preceding the name of the Event Source by an accent grave (`). They are
displayed in blue in the user interface.
The only way to control an Event Value externally (for example, by a MIDI keyboard, fader, sequencer,
etc.) is to map it to one of the following Event Sources:
`MIDIKeyDown `MIDIKeyNumber `MIDIKeyVelocity
`MIDIController00 thru `MIDIController127
`MIDIPitchBend `MIDITimeCode `MIDIChannelPressure
`MIDIProgramNumber
MIDI Continuous Controller Sources
MIDI continuous controller Event Sources are designated as `MIDIController00 through `MIDI-
Controller127. The signal processor automatically scales the continuous controller values received via
MIDI control change messages (which are in the range of (0,127)) to the range of (0,1).
MIDI Keyboard Sources
MIDI note on and off messages control the Event Sources `MIDIKeyDown, `MIDIKeyNumber, and
`MIDIKeyVelocity. Kyma treats MIDI note on messages with zero velocity in the same way as MIDI
note off messages with a velocity equal to the velocity of the original note on message.
`MIDIKeyDown is set in the following way:
♦ a note off message causes it to be set to 0
♦ a note on message causes it to first be set to -1, and then, five milliseconds later, to be set to +1
A value of -1 in the trigger of an envelope (for example, ADSR) tells the envelope to rapidly decay the
envelope to zero. The later value of +1 tells the envelope to begin its attack.
`MIDIKeyNumber contains the key number from the note on message. It is set at the same time that
`MIDIKeyDown is set to +1.
The velocity part of a MIDI note message is scaled from its range of (0,127) to the range of (0,1).
`MIDIKeyVelocity is set to this scaled value at the same time that `MIDIKeyDown is set to +1.
MIDI note events are allocated to individual voices within a MIDIMapper or MIDIVoice according to the
polyphony, MIDI channel and pitch range specified in the mapping Sound. A note is allocated to the oldest
voice that is not in use, or, if all voices are currently in use, the voice that has been on for the longest
amount of time.
Other MIDI Sources
The remaining MIDI messages are mapped in the following way:
♦ MIDI program change messages cause the Event Source `MIDIProgramNumber to be set to the new
program number. Program numbers are in the range of 1 to 128.
♦ MIDI channel aftertouch messages cause the Event Source `MIDIChannelPressure to be set to the
channel pressure value (scaled from (0,127) to (0,1)).
♦ MIDI pitch bend messages set `MIDIPitchBend. Its range of (-2048,2048) is scaled to the range
of (-1,1).
♦ MIDI time code messages cause `MIDITimeCode to be set to the time received. Additionally,
`RealTime (the time in seconds since the Sound was started) is updated whenever these messages
are received.
Signal Processor Sources
The signal processor itself is the source of some Event Sources:
♦ `Time is the time in seconds since the entire Sound structure was started.
♦ `LocalTime is the time in seconds since the Sound using `LocalTime was started.
474