The Kyma Language for Sound Design, Version 4.5

Event Value via the MIDI input of the signal processor or by some other software running on your computer.
‡
The Event Values displayed in the virtual control surface are organized alphabetically from left to right.
Each type of control: annotations, oscilloscope and spectrum analyzer displays, faders, gates, small faders,
and toggles occupies a separate row on the virtual control surface. The type of display a particular
Event Value will have depends on the settings in the local or global map that defines the Event Value; see
Virtual Control Surface and Mappings on page 483. Any Event Value not defined in a map will be displayed
as a fader. See the quick reference on page 212 for information on how to use the controls within
the virtual control surface.
When you use an Event Value that is defined in the global map, the specified Event Source will supply
values to that Event Value. If you use an Event Value not defined in the global map, Kyma will create a
new Event Source that gets its value from the virtual control surface.
Global and Local Maps
The Global Map
Unless you specify otherwise, Event Values in your Sounds are evaluated in the context of a global map
that associates Event Values with Event Sources. You can override the global map by using a local map
specified in the Map field of a MIDIMapper Sound.
To edit a global map, choose Open… from the File menu, select Global map as the file type and select the
global map file to edit. You can create a new global map by choosing New… from the File menu and by
selecting Global map as the new file type.
The global map editor is simply a text editor. Make changes to the global map as you would to any text
file, choosing Save, Save as…, or Close from the File menu to save any changes that you have made. Use
Choose global map… from the File menu to tell Kyma which global map to use when compiling Sounds.
Your system arrives with a default global map, but you may find that a customized global map is helpful
when working with the MIDI controllers found in your studio. To see the default map on-line, choose
Open… from the File menu, select Global map as the file type, then select the file named Default (in
the Global Maps folder) from the file list.
You can create your own customized global map that corresponds to the specific MIDI devices that you
use with Kyma. For example, Kyma comes with example global maps for use with the Peavey PC 1600
MIDI controller (called PC1600) and the Buchla Lighting wand-based controller (called Lighting).
It is a good idea to create a new map rather than modifying the default map and saving it; that way you
always have the original map to use as a reference.
You can also override the global map locally. To override or extend the global map, use a MIDIMapper
Sound. In the Map parameter of the MIDIMapper, you only need to enter the associations that are different
from the associations in the global map. When you use a MIDIMapper to change the global map, the
changes you make affect only Sounds to the left of the MIDIMapper in the signal flow diagram and only
for the duration of those Sounds — not in any permanent way.
Specifying the Map
A map (whether in the global map file or in the Map field of a MIDIMapper Sound) associates Event Values
with Event Sources.
There are several ways to specify this association, all variants of the following syntax:
!anEventValue is: `anEventSourceOrExpression.
‡ To send MIDI data to Kyma from another program, connect your keyboard controller to the MIDI input on your
computer or MIDI interface, connect the MIDI output of your MIDI interface to the MIDI input of the signal processor;
then run Kyma and the other program simultaneously. (It is recommended that you switch off your
computer when connecting MIDI cables.) Remember that when you want to use Kyma alone you might have to
explicitly patch a MIDI thru connection using a MIDI patcher on your host computer.
482