The Kyma Language for Sound Design, Version 4.5

MultisegmentEnvelope
Envelopes & Control Signals Category
Similar to the ADSR envelope, except that you can specify an arbitrary number of segments and can
specify loop points. See also MultiSlopeFunctionGenerator and GraphicalEnvelope. Use the
GraphicalEnvelope except in those cases where you need hot BreakPoints or Levels.
Typical uses include amplitude envelopes, pitch envelopes, and time index functions.
Durations
Enter the durations of each segment of the envelope. You must include the units of time and enclose the
duration and its units within curly braces, for example
{!Length s} or {2 s}
The number of Durations must be one less than the number of BreakPoints.
BreakPoints
These are the amplitude values at the endpoints of each segment. There should always be one more
breakpoint than there are segment durations. Every time there is a change in slope or a "break" in the
line corresponding to the envelope, you have to specify the amplitude at that point (including the very last
point in the envelope, since it does not necessarily have to end on a zero). These numbers can be any
value from 0 to 1. If you enter a larger value, the amplitude of the envelope will approach that number at
the rate required to reach that number in the given duration, but it will stick at the value of 1 once that has
been reached.
StartLoop
The number of the first segment included in the loop (where the segments are numbered from 1 to the
number of segments).
EndLoop
The number of the last segment included in the loop (where the segments are numbered from 1 to the
number of segments).
Level
This is a scale factor (from 0 to 1) for attenuating the overall output level.
Gate
When Gate changes from zero to a nonzero, the envelope will be triggered. Gate must return to zero
again before the envelope can be retriggered. If you have specified beginning and ending segments for a
loop, the envelope will repeat the loop segments for as long as the Gate is nonzero. If the ending loop
segment ends on a higher or lower value than the start of the beginning segment, the entire looped
portion will get larger or smaller each time it is repeated (because each segment has a *slope* associated
with it, not the absolute values at each point).
304