The Kyma Language for Sound Design, Version 4.5

Sequences and Mixes
An EventSequence is a collection of events that occur in time order. The syntax for creating an EventSequence
is:
EventSequence events: anArray.
An EventMix is a collection of events that occur at the same time. The syntax for creating an EventMix is:
EventMix events: anArray.
There are several ways to create the Array. You can specify each item in the array:
EventSequence events:
(Array
with: (Note durationInBeats: 1 frequency: 3 g)
with: (Note durationInBeats: 1 frequency: 4 e)
with: (Note durationInBeats: 2 frequency: 4 c))
You can collect items that you create within a loop:
EventSequence events:
((1 to: 100) collect: [ :i |
Note durationInBeats: 2 frequency: 4 c + (i * 2) nn])
Or you can put literal values within parentheses preceded by a sharp sign. If you create the Array this
way, remember to enclose the Notes and Rests within curly braces to make them literal values:
EventMix events:
#( {Note durationInBeats: 1 frequency: 3 g}
{Note durationInBeats: 1 frequency: 4 e}
{Note durationInBeats: 2 frequency: 4 c} )
TimedEventCollections
A TimedEventCollection is a collection of events together with the starting beat for each event. One way
to create a TimedEventCollection is:
TimedEventCollection startingBeats: beats events: events.
where beats is a collection of the starting beat numbers for each event in the events collection.
You can also create a TimedEventCollection by reading in the events and starting beats from a MIDI file.
If all you want to do is play exactly what’s in the MIDI file, then it would be quicker and more straightforward
to simply select MIDI file as the Source in your MIDIVoice. However, once you have read the
MIDI file into a TimedEventCollection you can transform it, twist it, distort it, in short, do all the kinds
of things composers love to do!
The syntax for reading a MIDI file is:
TimedEventCollection timesAndEventsFromMIDIFile: 'file.mid' channel: 1.
Generic EventCollections
An EventCollection is a collection of Notes and Rests without any ordering. To create an EventCollection,
use:
EventCollection events: anArray.
Where anArray is a collection of Notes, Rests and other collections of events.
The message randomizeUsing:totalBeats:quantizeTo:maxSpacing: forces an EventCollection
to become a TimedEventCollection by generating a set of random starting beats and randomly picking a
set of events from the events supplied:
(EventCollection events: anArray)
randomizeUsing: (Random newForKymaWithSeed: 92)
totalBeats: 16
524