The Kyma Language for Sound Design, Version 4.5

FunctionGenerator
Envelopes & Control Signals Category
Reads the specified Wavetable for the specified OnDuration whenever it receives a Trigger.
Useful for envelope generation or for reading recordings stored in the wavetable memory (see also the
Sample prototype).
In a prototype with an Envelope parameter field (Oscillator, for example) you can use the
FunctionGenerator directly as the Envelope parameter. A FunctionGenerator can also be used to control
other parameters (such as Frequency or OnDuration). To apply an envelope to any Sound, use the
Sound and an envelope generator as Inputs to the VCA prototype. (The VCA simply multiplies its two
inputs by each other).
Trigger
When the Trigger becomes nonzero, one event is triggered. You can trigger several events over the
course of the total Duration of this program as long as the value of Trigger returns to zero before the next
trigger. Some example values for Trigger are:
1 (plays once with no retriggering)
0 (the sound is silent, never triggered)
!KeyDown (trigger on MIDI key down)
!F1 (trigger when MIDI switch > 0)
You can also paste another signal into this field, and events will be triggered every time that signal
changes from zero to a nonzero value. (See the manual for a complete description of hot parameters,
EventValues, EventSources, and Map files).
OnDuration
This is the duration of each triggered event. It should be the same length or shorter than the value in
Duration (which is the total length of time that this program is available to be triggered). Think of Duration
as analogous to the total lifetime of a piano string, and OnDuration as the duration of each individual note
that you play on that piano string. The OnDuration must be greater than zero, and you must specify the
units of time, for example:
2 s (for 2 seconds)
2 ms (for 2 milliseconds)
200 usec (for 200 microseconds)
2 m (for 2 minutes)
2 h (for 2 hours)
2 days
2 samp (for 2 samples)
1 / 2 hz (for the duration of one period of a 2 hz signal)
Wavetable
This is the name of the function that will be generated (or the sample that will be played) each time the
FunctionGenerator is triggered.
FromMemoryWriter
Check FromMemoryWriter when the wavetable does not come from a disk file but is recorded by a
MemoryWriter in real time.
264