The Kyma Language for Sound Design, Version 4.5

Variables
could be rewritten as a loop:
0 to: 2 do: [ :i |
anInstr
start: i s
freq: ((i + 1) * 100) hz
dur: 1 s].
In the loop above, the expression within brackets
anInstr start: i s
freq: ((i + 1) * 100) hz
dur: 1 s
is iteratively evaluated with i set to the values 0, 1, and 2.
To learn more about how you can use Smalltalk in a script, refer to the Script examples in the file
Scripts.
Kyma Variables
A Kyma variable represents the value of a Sound parameter; it can be a Variable Sound, a SoundCollectionVariable,
or a name preceded by a question mark.
You can use Kyma variables in a script. The following example plays a harmonic series (of ?total harmonics
of 100 hz, spaced 1 second apart):
1 to: ?total do: [ :i |
pluck start: (i - 1) s freq: (100 * i) hz].
The variable ?total controls the number of times the code within the square brackets is executed; thus,
it determines the number of events in this Script. When you load this Script Sound, Kyma will prompt
you for a value for ?total. As the use of Kyma variables in this sample script suggests, scripts can be
used as inputs of other scripts.
Variables in Scripts and FileInterpreters
Each event in a Script or FileInterpreter script corresponds to a mapping of variable names to values for
those variables. When you load a Script, it binds the variables of its input(s) to the values supplied in the
script.
You can see a list of the selected Sound’s variables by choosing Get info from the Info menu.
If the script fails to map one of the variables to a value, then you must supply a value for that variable in
some other way, either by entering values when prompted, by using the Sound as an example for a new
class, or by making the Sound an input of another Script or FileInterpreter.
Kyma variables in the script of a Script or a FileInterpreter are treated just like variable parameters. These
variables must be set from “outside” (that is, from some Sound to the right of them in the signal flow diagram).
Smalltalk Variables
You can also use Smalltalk variables in a script. A Smalltalk variable has no preceding question mark;
instead it has to be declared at the beginning of the script in which it is used. Smalltalk variables are used
as temporary storage locations within a script. They do not directly represent Sound parameters.
A Smalltalk variable is defined only within the script in which it appears. A Kyma variable is defined
throughout the entire Sound structure in which it appears.
Smalltalk variables must be declared at the beginning of the Script by typing them between vertical lines,
| curTime curFreq |
528