The Kyma Language for Sound Design, Version 4.5

Script
Scripts Category
A Script is a handy way to construct Sounds algorithmically (rather than piecing them together graphically
in the Sound editor). The constructed Sound will be a Mixer of several Inputs, each with its own start
time (or TimeOffset).
A Script is like any other Sound in that it can be used as an Input to a more complex Sound; for example,
a Script can contain variables and can even be used as an Input to another Script.
Inputs
Use the script to schedule each of these Sounds at a specific time and to supply values for any variables
in the Sound’s parameters. (Script actually uses each of these Input Sounds as a template or model for
creating new instances of the Sounds with specific values at specific times. Multiple instances of a
Sound can be scheduled from the script by specifying simultaneous start times or overlapping durations.)
Script
The script supplies start times for the Sounds in the Inputs field and, optionally, sets the values of any
variable parameters. To specify an event in the script, type:
start: {: }.
In other words, type the name of an Input Sound, a space, the word "start" followed by a colon and then a
space, a start time followed by units of samp or s or beats, and then any number of
pairs followed by a period. The pairs consist of the name of a variable in the Input, a
colon, a space, and then a value for that variable. To specify the length of a beat, assign the desired
metronome setting to the variable MM. If an Input takes another Sound as an argument, you can supply
it from the script as a parenthesized event with no start time.
Any Smalltalk expression can appear in the script, including temporary variable declarations and control
structures like loops.
See the manual for more details and examples.
Left
This controls the level of the left output channel. The maximum value is 1 and the minimum is -1. The
left channel of the output is multiplied by the value of this parameter. Some example values for Left are:
1 (no attenuation)
0 (maximum attenuation)
!Fader1 (continuous controller sets level)
!KeyVelocity (MIDI key velocity controls the amplitude)
You can also paste another signal into this field, and the amplitude will vary with the output amplitude of
the pasted signal (something like an LFO controlling the attenuation). (See the manual for a complete
description of hot parameters, EventValues, EventSources, and Map files).
Right
This controls the level of the right output channel. The maximum value is 1 and the minimum is -1. The
right channel of the output is multiplied by the value of Right. Some example values for Right are:
1 (no attenuation)
343