The Kyma Language for Sound Design, Version 4.5

its range of legal values, its default value, its list of units, and whether it requires units (e.g., hz or s). The
type is used by the Sound editor to check whether the values entered in the parameter fields make sense
for those particular parameters. Later, when you compile a Sound of this new class, any parameter fields
with invalid values will flash and the host computer will beep twice.
The best way to learn about types is to use the class editor to inspect the parameter types of some of the
system Sound classes. See the table at the end of this chapter for an exhaustive listing of the types and
their ranges.
Parameter Fields
Field describes the kind of field the parameter will have in the Sound editor. The kind of field determines
how you will be able to enter values for that parameter in the Sound editor. For example, a
hotValue field lets you type Event Values as well as constants, and a soundCollection field allows
you to drag multiple Sounds into the field.
In the Sound class editor, the contents of the Field list depends upon the currently selected Type; only
those fields that are legal for the selected type are shown.
The different kinds of fields available are as follows:
Field Description
array Allows you to type in values separated by spaces; this field accepts them
in order as an array.
boolean A check box that allows you to choose true or false.
codeString Used in Script, the FileInterpreters, and ParameterTransformer for the
Script or Transformation field. It parses what you have entered and
checks its syntax whenever you try to load or edit another Sound. A
codeString provides you with more detailed error messages than a
value field does.
fileName A browse button that opens a file list dialog.
grammar The field used for the production rules of ContextFreeGrammar. See the
Prototypes Reference on page 218.
legalNameSound-
Collection
Accepts any number of Sounds with legal variable names. This is needed
in Script and the FileInterpreters so that you can refer to the Sounds by
name in the Script.
radioButtons Presents built-in choices (depending on the type of field) as a column of
radio buttons. For example, if you choose radio button in the class editor
for the type of the WordSize field in a DiskRecorder, the WordSize field
will display radio buttons corresponding to the three word size choices.
radioButtonsTwoColumns Same as radioButtons, but displays in two columns.
samplesFileList The field used in the Segments parameter of the SamplesFileSplicer.
sound Accepts only one Sound at a time.
soundCollection Accepts any number of Sounds.
string A text editor that will accept any sequence of characters. It cannot be set
to a variable.
symbolList A pop-up list of choices that presents a list of values.
value Allows you to type any value, variable, or expression. The expression is
evaluated when you load or edit another Sound.
wavetable Allows you to select a sample from a file dialog or to type in the name of
a sample file or a variable.
538