1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
title:: Event types
summary:: Different ways that an Event can "play"
categories:: Streams-Patterns-Events>Events
related:: Classes/Event
An link::Classes/Event:: responds to a code::play:: message by evaluating ~play in the event, and the default behaviour of ~play is determined by the value of ~type.footnote::To see how event types are normally invoked, here is a slightly simplified version of the default definition of ~play as defined in the Event class:
code::{ ~eventTypes[~type].value(server); }::
The function uses the value of ~type to select a function from the Dictionary held in ~eventTypes. ::
code::
a = (play: { ~word.scramble.postln }, word: "hello word");
a.play;
a = (type: \note, freq: [1310, 1321]); // choosing a play function by specifying type
a.play;
::
The collection of eventTypes can be readily extended using link::Classes/Event#*addEventType#*addEventType:::
code::
Event.addEventType(\test, { "Your word is: ".post; ~word.scramble.postln });
(type: \test, word: "annahme").play;
::
section::Currently existing event types:
Note:: this documentation is incomplete. ::
definitionlist::
## note || Instantiate a synth on the server, with specified arguments, and later to free it. The choice of link::Classes/SynthDef:: is specified using the \instrument key. This event type is what code::Event.default:: returns.
code::(degree: [0, 5, 7, 11]).play;::
Actually plays this event type:
code::(type: \note, degree: [0, 5, 7, 11], instrument: \default).play;::
## set || used to set parameters of some already-running node(s).
code::
a = (degree: 3, sustain: 40).play;
fork { 10.do { (type: \set, id: a[\id], \degree: [0, 5, 8, 11].choose).play; 0.3.wait } };
::
(See also: note in link::Classes/Pmono:: helpfile)
## group || creates a new group
optional parameters:
table::
## ~id || node ID, or node object
## ~group || outer group id or object
## ~addAction / ~lag / ~timingOffset || determine how and when the group is created
::
Example:
code::
(type: \group, id: 2).play // create a group with nodeID 2
(type: \note, freq: 500, group: 2).play // play a synth in that group
::
## midi || send note parameters to midi device
parameters:
table::
## ~midicmd || A Symbol, for the MIDI command to issue
## ~midiout || A MIDIOut object
## ~chan || The MIDI channel number (0-15)
::
See link::Tutorials/A-Practical-Guide/PG_08_Event_Types_and_Parameters#MIDI output:: for details on available midicmds.
## on || play synth, ~id must be specified
## off || release synth (or free if no gate)
## kill || free synth
## rest || do nothing for a specified amount of time
## composite || perform any number of event types, given as ~types
code::
MIDIClient.init;
m = MIDIOut(0);
// should play a synth *and* an external MIDI note simultaneously
(type: \composite, types: [\note, \midi], midiout: m, degree: 0, dur: 3).play;
::
## bus || write ~array to control buses starting at ~out
## audioBus || allocate ~channels consecutive audio buses
## controlBus || allocate ~channels consecutive control buses
## alloc || allocate ~bufnum with ~numframes and ~numchannels
## allocRead || load a file from ~path, starting at ~firstFileFrame, reading ~numFrames sample frames
## cue || cue a file for DiskIn, with ~bufferSize frames
## free || free ~bufnum
## gen || send ~gencmd to ~bufnum
## load || load ~filename starting at ~frame into ~bufnum
## read ||
## table || load ~amps directly into a buffer
## sine1 || generate a buffer from ~amps
## sine2 || generate a buffer from ~freqs, ~amps
## sine3 || generate a buffer from ~freqs, ~amps, ~phases
## cheby || generate a waveshape buffer from ~amps
## setProperties || sends setter messages to ~receiver for each key in ~args that has a nonNil value in the Event.
## tree || creates a tree of groups. ~tree can be an array of nodeIDs, and may contain associations to further nested arrays.
## phrase || instead of playing a single synth from a SynthDef with ~instrument, it looks up a Pdef and plays a cluster of sounds.
::
subsection::Some event types are used internally, e.g.:
definitionlist::
## monoNote || used by Pmono
## monoSet || used by Pmono
## monoOff || used by Pmono
::
|
