The Kyma Language for Sound Design, Version 4.5

SyntheticSpectrumFromArray
Spectral Sources Category
Creates a synthetic spectrum from two arrays: an array of amplitude values for each track in the frame,
and an array of frequency values for each track in the frame (and, if SendBandwidths is checked, a
corresponding array of bandwidths for each of the tracks as well). A SyntheticSpectrumFromArray
should be fed to an OscillatorBank, FormantBankOscillator, or VocoderChannelBank in order to
synthesize the partials, formants, or bank of vocoder filters. The SyntheticSpectrumFromArray produces
a set of envelopes for controlling the parameters of an OscillatorBank, FormantBankOscillator, or
VocoderChannelBank.
NbrPartials
This is the number of partials (or filters) to synthesize. In most cases, it should be the same as the size of
the Frequencies array; however, you can specify a slower update rate for the envelopes by using a larger
number here. The time between updates of the control envelopes is equal to the number you specify
here but in units of samples. If you enter 128 here, for example, the envelopes will be updated every 128
samples (that is about every 3 milliseconds if your sampling rate is 44.1 kHz).
LogScale
Check this box to output the Frequencies (and, optional Bandwidths) in log rather than linear frequency.
In most cases, this box should be unchecked; the only time it should be checked is if you want to
manipulate the frequency envelopes in pitch space rather than in hertz.
SendBandwidths
Check this box to send bandwidth information. Bandwidths are required for controlling the filters of a
FormantBankOscillator or a VocoderChannelBank, but they are not required for controlling the oscillators
in an OscillatorBank.
Envelope
This is an overall amplitude envelope.
Amplitudes
Enter an array of amplitude values separated by spaces. Enclose any arithmetic expressions or units
within curly braces, for example:
!Amp1 {!Amp2 * 0.5} {-6 db} !KeyVelocity {!KeyDown ramp: 5 s} {0.1 s random}
The number of amplitude values should be the same as the number of frequency values (and optional
bandwidth values). If the frequency, amplitude (and bandwidth if used) arrays are different sizes, the
smallest array will be used, and any extra values in the other two arrays are thrown away.
Frequencies
Enter an array of frequency values separated by spaces. If you leave off the units, the values will be
interpreted as frequencies in hertz. Enclose any arithmetic expressions or frequencies with units within
curly braces, for example:
609 {!Freq1 * 1000} {2048 hz} {60 nn} {5 c}
The number of frequency values should be the same as the number of amplitude values (and optional
bandwidth values). If the frequency, amplitude (and bandwidth if used) arrays are different sizes, the
371