[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[sc-dev] SF.net SVN: supercollider:[8246] trunk/build/Help/Collections/Event.html
Revision: 8246
http://supercollider.svn.sourceforge.net/supercollider/?rev=8246&view=rev
Author: rkuivila
Date: 2008-12-22 21:15:00 +0000 (Mon, 22 Dec 2008)
Log Message:
-----------
Updated Event help file to include discussion of arrayed arguments
Modified Paths:
--------------
trunk/build/Help/Collections/Event.html
Modified: trunk/build/Help/Collections/Event.html
===================================================================
--- trunk/build/Help/Collections/Event.html 2008-12-22 21:10:44 UTC (rev 8245)
+++ trunk/build/Help/Collections/Event.html 2008-12-22 21:15:00 UTC (rev 8246)
@@ -9,15 +9,15 @@
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 18.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
-p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
-p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica; min-height: 17.0px}
-p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
+p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
+p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
+p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica; min-height: 17.0px}
p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Monaco; min-height: 16.0px}
-p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #a91616}
+p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #961e1e}
p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
p.p9 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
p.p10 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #000006; min-height: 14.0px}
-p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0014bc}
+p.p11 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #001db9}
p.p12 {margin: 0.0px 0.0px 0.0px 0.0px; font: 11.0px Monaco}
p.p13 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; color: #000006}
p.p14 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Monaco}
@@ -25,68 +25,69 @@
span.s1 {font: 12.0px Monaco}
span.s2 {font: 13.0px Monaco}
span.s3 {color: #000000}
-span.s4 {color: #a91616}
+span.s4 {color: #961e1e}
span.s5 {color: #000006}
-span.s6 {color: #001afb}
+span.s6 {color: #0026f7}
span.s7 {color: #606060}
-span.s8 {color: #0014bc}
+span.s8 {color: #001db9}
span.s9 {font: 9.0px Monaco}
-span.s10 {font: 12.0px Helvetica; color: #001afb}
+span.s10 {font: 12.0px Helvetica; color: #0026f7}
span.s11 {font: 12.0px Helvetica}
-span.s12 {color: #307109}
+span.s12 {color: #426f0e}
span.Apple-tab-span {white-space:pre}
</style>
</head>
<body>
<p class="p1"><b>Event</b></p>
<p class="p2"><br></p>
-<p class="p3"><b>superclass: Environment</b></p>
-<p class="p3"><b>related classes: Pattern</b></p>
-<p class="p4"><br></p>
-<p class="p3"><b>Class variables</b></p>
+<p class="p3"><b>Inherits from: Object : Collection : Set : Dictionary : IdentityDictionary : Environment</b></p>
+<p class="p4"><b>related classes: Pattern</b></p>
+<p class="p5"><br></p>
+<p class="p4"><b>Class variables</b></p>
<p class="p2"><br></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>defaultParentEvent<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>the default event used in most cases</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>parentEvents<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>an IdentityDictionary of useful parent events</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>partialEvents<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>an IdentityDictionary of Events that define the default values and functions</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>for different aspects of note generation (timing, volume, pitch, server to use, etc)</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>defaultParentEvent<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>the default event used in most cases</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>parentEvents<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>an IdentityDictionary of useful parent events</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>partialEvents<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>an IdentityDictionary of Events that define the default values and functions</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>for different aspects of note generation (timing, volume, pitch, server to use, etc)</p>
<p class="p2"><br></p>
-<p class="p5"><b>Class methods</b></p>
+<p class="p4"><b>Creation / Class Methods</b></p>
<p class="p2"><br></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>*new { | n, proto, parent, know = true)<span class="Apple-tab-span"> </span></b>create an event</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>*default<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns an empty event with defaultParentEvent as parent</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>*silent (dur)<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns an event that describes a pause</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>*addEventType(type, func)<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>Event types define alternate play functions that</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>are selected by the value of <span class="s1">~type</span></p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>*new { | n, proto, parent, know = true)<span class="Apple-tab-span"> </span></b>create an event</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>*default<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns an empty event with defaultParentEvent as parent</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>*silent (dur)<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns an event that describes a pause</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>*addEventType(type, func)<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>Event types define alternate play functions that</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>are selected by the value of <span class="s1">~type</span></p>
<p class="p2"><b><span class="Apple-tab-span"> </span></b></p>
-<p class="p5"><b>Methods</b></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>play the event</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>delta<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns a time delay until the next event in a sequence</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>next<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>used to enable events to be composed<span class="Apple-converted-space"> </span></p>
+<p class="p3"><b>Methods</b></p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>play the event</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>delta<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>returns a time delay until the next event in a sequence</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>next<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>used to enable events to be composed<span class="Apple-converted-space"> </span></p>
+<p class="p3"><span class="Apple-tab-span"> </span><b>playAndDelta(cleanup, mute)<span class="Apple-tab-span"> </span></b> used by EventStreamPlayer to play Events and obtain a time increment</p>
<p class="p2"><b><span class="Apple-tab-span"> </span></b></p>
-<p class="p5"><b>Methods that allow Events to provide user control for Synths on Groups</b></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>synth<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>makes the event a control interface to the resultant synth when played</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>group<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>makes the event a control interface to the resultant group when played<span class="Apple-converted-space"> </span></p>
+<p class="p3"><b>Methods that allow Events to provide user control for Synths on Groups</b></p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>synth<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>makes the event a control interface to the resultant synth when played</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>group<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>makes the event a control interface to the resultant group when played<span class="Apple-converted-space"> </span></p>
<p class="p2"><b><span class="Apple-tab-span"> </span></b></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>stop<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>free the synth or group</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>pause<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>pause the synth or group</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>resume<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>resume the synth or group</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>release<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>release the synth or group</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>set<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>set a control value in the synth or group</p>
-<p class="p4"><br></p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>stop<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>free the synth or group</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>pause<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>pause the synth or group</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>resume<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>resume the synth or group</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>release<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>release the synth or group</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>set<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>set a control value in the synth or group</p>
+<p class="p5"><br></p>
<p class="p2"><br></p>
-<p class="p5">An Event is an Environment that specifies an action to be taken in response to a <span class="s2">play</span><b> </b>message. The key/value pairs within the Event specify the parameters of that action.<span class="Apple-converted-space"> </span></p>
+<p class="p3">An Event is an Environment that specifies an action to be taken in response to a <span class="s2">play</span><b> </b>message. The key/value pairs within the Event specify the parameters of that action.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
-<p class="p5">Event provides a <span class="s1">defaultParentEvent</span> that defines a variety of different event types and provides a complete set of default key/value pairs for each type.<span class="Apple-converted-space"> </span>The type is determined by the value of the <span class="s1">key \type </span>which defaults to <span class="s1">\note</span>.<span class="Apple-converted-space"> </span>Note events create synths on the server.</p>
+<p class="p3">Event provides a <span class="s1">defaultParentEvent</span> that defines a variety of different event types and provides a complete set of default key/value pairs for each type.<span class="Apple-converted-space"> </span>The type is determined by the value of the <span class="s1">key \type </span>which defaults to <span class="s1">\note</span>.<span class="Apple-converted-space"> </span>Note events create synths on the server.</p>
<p class="p2"><br></p>
-<p class="p5">Events can be written as a series of key value pairs enclosed in parentheses.<span class="Apple-converted-space"> </span>Empty parentheses will create an empty event.<span class="Apple-converted-space"> </span></p>
+<p class="p3">Events can be written as a series of key value pairs enclosed in parentheses.<span class="Apple-converted-space"> </span>Empty parentheses will create an empty event.<span class="Apple-converted-space"> </span></p>
<p class="p6"><br></p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(<span class="Apple-converted-space"> </span>).play;<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// the default note</p>
<p class="p8"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(<span class="Apple-converted-space"> </span>freq: 500,<span class="Apple-converted-space"> </span>pan: -1) .play;<span class="Apple-tab-span"> </span><span class="s4">// 500 Hz, panned left</span></p>
-<p class="p4"><b></b><br></p>
-<p class="p3"><b>Events and SynthDefs</b></p>
+<p class="p5"><br></p>
+<p class="p4"><b>Events and SynthDefs</b></p>
<p class="p10"><br></p>
-<p class="p5"><span class="s5">The key used to select what synthdef is to be played is </span><span class="s1">\instrument</span>.<span class="Apple-converted-space"> </span>In order to use a SynthDef with an Event, send it a <span class="s1">store </span>message.<span class="Apple-converted-space"> </span>This creates a description of the SynthDef that the event can consult to determine its control names. The values of these names in the event are used when the event is played. (See <a href="../ServerArchitecture/SynthDesc.html"><span class="s6"><b>SynthDesc</b></span></a><b> </b>for details.)</p>
+<p class="p3"><span class="s5">The key used to select what synthdef is to be played is </span><span class="s1">\instrument</span>.<span class="Apple-converted-space"> </span>In order to use a SynthDef with an Event, send it a <span class="s1">store </span>message.<span class="Apple-converted-space"> </span>This creates a description of the SynthDef that the event can consult to determine its control names. The values of these names in the event are used when the event is played. (See <a href="../ServerArchitecture/SynthDesc.html"><span class="s6"><b>SynthDesc</b></span></a><b> </b>for details.)</p>
<p class="p2"><br></p>
<p class="p11"><span class="s3"><span class="Apple-tab-span"> </span></span>SynthDef<span class="s3">(</span><span class="s7">"pm"</span><span class="s3">, { </span>| out=0, freq=440, amp=0.1, pan=0, gate=1, ratio = 1, index = 1, ar = 0.1, dr = 0.1 |</p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s8">var</span> z;</p>
@@ -101,16 +102,16 @@
<p class="p8"><span class="Apple-tab-span"> </span></p>
<p class="p9"><span class="Apple-tab-span"> </span>(instrument: <span class="s7">"pm"</span>, ratio: 3.42, index: 12, freq: 150, ar: 8, dr: 3, sustain: 10).play;</p>
<p class="p6"><span class="Apple-tab-span"> </span></p>
-<p class="p5"><span class="Apple-tab-span"> </span>note: The use of <span class="s1">OffsetOut</span> in the SynthDef prevents artifacts that can result from the interaction of the timing of a sequence of notes and the control rate of the Server.</p>
+<p class="p3"><span class="Apple-tab-span"> </span>note: The use of <span class="s1">OffsetOut</span> in the SynthDef prevents artifacts that can result from the interaction of the timing of a sequence of notes and the control rate of the Server.</p>
<p class="p2"><span class="Apple-tab-span"> </span></p>
-<p class="p3"><b>Multi-channel Expansion</b><span class="s9"><span class="Apple-tab-span"> </span></span></p>
+<p class="p4"><b>Multi-channel Expansion</b><span class="s9"><span class="Apple-tab-span"> </span></span></p>
<p class="p8"><br></p>
-<p class="p5">If a key relevant to the action is assigned an array, the action is repeated on each element of the array:</p>
+<p class="p3">If a key relevant to the action is assigned an array, the action is repeated on each element of the array:</p>
<p class="p8"><span class="Apple-tab-span"> </span></p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>( degree: (0..12)).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s4">// a diatonic cluster</span></p>
<p class="p2"><br></p>
-<p class="p5">If several keys are assigned arrays, the action is repeated for each element of the largest array.</p>
-<p class="p5">Smaller arrays are rotated through repeatedly.<span class="Apple-converted-space"> </span>Here are some examples:</p>
+<p class="p3">If several keys are assigned arrays, the action is repeated for each element of the largest array.</p>
+<p class="p3">Smaller arrays are rotated through repeatedly.<span class="Apple-converted-space"> </span>Here are some examples:</p>
<p class="p2"><br></p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>( degree: (0..12), amp: [0,0.1]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// every other note of the diatonic cluster: stacked thirds</p>
<p class="p2"><br></p>
@@ -119,11 +120,11 @@
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>( note: (0..12), amp: [0,0, 0.1]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// every third note of the semitone cluster: a diminished chord</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
-<p class="p5">Events may be used for object prototyping. See <a href="Environment.html"><span class="s6">Environment</span></a> for more details.</p>
+<p class="p3">Events may be used for object prototyping. See <a href="Environment.html"><span class="s6">Environment</span></a> for more details.</p>
<p class="p2"><br></p>
-<p class="p3"><b>Arrayed Arguments</b><span class="s9"><span class="Apple-tab-span"> </span></span></p>
+<p class="p4"><b>Arrayed Arguments</b><span class="s9"><span class="Apple-tab-span"> </span></span></p>
<p class="p8"><br></p>
-<p class="p5">It is possible to assign an array to one of a SynthDef's controls. For example:</p>
+<p class="p3">It is possible to assign an array to one of a SynthDef's controls. For example:</p>
<p class="p2"><br></p>
<p class="p12">SynthDef("test", { | out = 0, amp = 0.01, freq = #[300,400,400], pan, gate = 1 |</p>
<p class="p12"><span class="Apple-tab-span"> </span>var audio, env;</p>
@@ -133,16 +134,18 @@
<p class="p12"><span class="Apple-tab-span"> </span>OffsetOut.ar(0, audio );</p>
<p class="p12">}).store;</p>
<p class="p8"><span class="Apple-tab-span"> </span></p>
-<p class="p5">Within an event, arrayed arguments of this sort must be enclosed within an additional array to distinguish</p>
-<p class="p5">them from arguments intended for multi-channel expansion.</p>
+<p class="p3">Within an event, arrayed arguments of this sort must be enclosed within a Ref or an additional array to distinguish</p>
+<p class="p3">them from arguments intended for multi-channel expansion.</p>
<p class="p8"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
-<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(instrument: \test, note: [[0,2,4]]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>// one synth</p>
+<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(instrument: \test, note: `[0,2,4]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>// one synth, use Ref to prevent multi-channel expansion</p>
<p class="p8"><br></p>
+<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(instrument: \test, note: [[0,2,4]]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>// one synth, use enclosing array to prevent multi-channel expansion</p>
+<p class="p8"><br></p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(instrument: \test, note: [[0,2,4], 6 +[0,2,4]]).play<span class="Apple-tab-span"> </span>// two synths</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
-<p class="p5">If several keys are assigned arrays, the action is repeated for each element of the largest array.</p>
-<p class="p5">Smaller arrays are rotated through repeatedly.<span class="Apple-converted-space"> </span>Here are some examples:</p>
+<p class="p3">If several keys are assigned arrays, the action is repeated for each element of the largest array.</p>
+<p class="p3">Smaller arrays are rotated through repeatedly.<span class="Apple-converted-space"> </span>Here are some examples:</p>
<p class="p2"><br></p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>( degree: (0..12), amp: [0,0.1]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// every other note of the diatonic cluster: stacked thirds</p>
<p class="p2"><br></p>
@@ -151,12 +154,12 @@
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>( note: (0..12), amp: [0,0, 0.1]).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// every third note of the semitone cluster: a diminished chord</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
-<p class="p5">Events may be used for object prototyping. See <a href="Environment.html"><span class="s6">Environment</span></a> for more details.</p>
+<p class="p3">Events may be used for object prototyping. See <a href="Environment.html"><span class="s6">Environment</span></a> for more details.</p>
<p class="p2"><br></p>
<p class="p2"><br></p>
<p class="p2"><br></p>
-<p class="p4"><b></b><br></p>
-<p class="p3"><b>Events and Patterns</b></p>
+<p class="p5"><br></p>
+<p class="p4"><b>Events and Patterns</b></p>
<p class="p10"><br></p>
<p class="p13">Events are closely integrated with the Patterns library.<span class="Apple-converted-space"> </span>Different patterns can be bound to different keys (or collections of keys) to specify the resultant music.<span class="Apple-converted-space"> </span><span class="s3">See the help<span class="Apple-converted-space"> </span>files <a href="../Streams-Patterns-Events/Pattern.html"><span class="s10"><b>Pattern</b></span></a><b> </b>and <a href="../Streams-Patterns-Events/Pbind.html"><span class="s10"><b>Pbind</b></span></a><b> </b>and the tutorials<span class="Apple-converted-space"> </span><a href="../Streams-Patterns-Events/Streams-Patterns-Events4.html"><span class="s10"><b>Streams-Patterns-Events4</b></span></a> and <a href="../Streams-Patterns-Events/Streams-Patterns-Events5.html"><span class="s10"><b>Streams-Patterns-Events5</b></span></a><b> </b>for more details on Patterns.</span></p>
<p class="p2"><br></p>
@@ -181,52 +184,52 @@
<p class="p9"><span class="Apple-tab-span"> </span>]);</p>
<p class="p9"><span class="Apple-tab-span"> </span>p.play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
<p class="p9">)<span class="Apple-tab-span"> </span></p>
-<p class="p4"><br></p>
-<p class="p3"><b>Event's play method</b></p>
+<p class="p5"><br></p>
+<p class="p4"><b>Event's play method</b></p>
<p class="p2"><br></p>
-<p class="p5">When an Event<span class="Apple-converted-space"> </span>(or any other Environment) receives a <span class="s1">use(function)</span> message, it sets itself to be currentEnvironment, evaluates the function, and restores the original value of currentEnvironment. This allows the function to access and alter the contents of the event using the following shortcuts:</p>
+<p class="p3">When an Event<span class="Apple-converted-space"> </span>(or any other Environment) receives a <span class="s1">use(function)</span> message, it sets itself to be currentEnvironment, evaluates the function, and restores the original value of currentEnvironment. This allows the function to access and alter the contents of the event using the following shortcuts:</p>
<p class="p2"><br></p>
<p class="p14"><span class="s11"><span class="Apple-tab-span"> </span></span>~keyName<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s11">which is equivalent to<span class="Apple-tab-span"> </span></span>currentEnvironment.at(keyName)</p>
-<p class="p5">and</p>
+<p class="p3">and</p>
<p class="p14"><span class="s11"><span class="Apple-tab-span"> </span></span>~keyName = value<span class="Apple-tab-span"> </span><span class="s11">which is equivalent to<span class="Apple-tab-span"> </span></span>currentEnvironment.put(keyName, value)</p>
<p class="p6"><br></p>
-<p class="p5">We will write ~keyName whenever referring to the value stored at the key keyName in the event. <span class="Apple-converted-space"> </span></p>
+<p class="p3">We will write ~keyName whenever referring to the value stored at the key keyName in the event. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
-<p class="p5">Here is the definition of Event's play method:</p>
+<p class="p3">Here is the definition of Event's play method:</p>
<p class="p2"><br></p>
<p class="p9"><span class="Apple-tab-span"> </span>play {</p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>if (parent.isNil) { parent = defaultParentEvent };</p>
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s8">this</span>.use { ~play.value };</p>
<p class="p9"><span class="Apple-tab-span"> </span>}</p>
<p class="p2"><br></p>
-<p class="p5">Thus we can see that the defaultParentEvent is used unless otherwise specified and the function stored in <span class="s1">~play </span>is executed in the context of the Event.</p>
-<p class="p4"><br></p>
-<p class="p3"><b>Timing control with Event's delta method</b></p>
+<p class="p3">Thus we can see that the defaultParentEvent is used unless otherwise specified and the function stored in <span class="s1">~play </span>is executed in the context of the Event.</p>
+<p class="p5"><br></p>
+<p class="p4"><b>Timing control with Event's delta method</b></p>
<p class="p2"><br></p>
-<p class="p5">Events also specify timing within a Pattern.<span class="Apple-converted-space"> </span>Event's <span class="s1">delta </span>method returns the<span class="Apple-converted-space"> </span>value of <span class="s1">~delta </span>or, if that is nil,<span class="Apple-converted-space"> </span><span class="s1">~dur * ~stretch.<span class="Apple-converted-space"> </span></span></p>
+<p class="p3">Events also specify timing within a Pattern.<span class="Apple-converted-space"> </span>Event's <span class="s1">delta </span>method returns the<span class="Apple-converted-space"> </span>value of <span class="s1">~delta </span>or, if that is nil,<span class="Apple-converted-space"> </span><span class="s1">~dur * ~stretch.<span class="Apple-converted-space"> </span></span></p>
<p class="p6"><br></p>
-<p class="p5">Patterns are played by<b> TempoClock' s</b>, which have their own tempo controls.<span class="Apple-converted-space"> </span>This tempo which can be controlled through <span class="s1">~tempo </span>in the event. Changes to the tempo affect everything else scheduled by the TempoClock, so <span class="s1">tempo </span>provides a global tempo control while <span class="s1">stretch </span>provides a control limited to the one pattern.</p>
-<p class="p4"><br></p>
-<p class="p3"><b>The structure of defaultParentEvent</b></p>
-<p class="p4"><br></p>
-<p class="p5">The default parent event provides the collection of default values and functions needed for the different uses of an Event. These<span class="Apple-converted-space"> </span>defaults are defined in partialEvents that specify distinct aspects of default parent Event:<span class="Apple-converted-space"> </span></p>
+<p class="p3">Patterns are played by<b> TempoClock' s</b>, which have their own tempo controls.<span class="Apple-converted-space"> </span>This tempo which can be controlled through <span class="s1">~tempo </span>in the event. Changes to the tempo affect everything else scheduled by the TempoClock, so <span class="s1">tempo </span>provides a global tempo control while <span class="s1">stretch </span>provides a control limited to the one pattern.</p>
+<p class="p5"><br></p>
+<p class="p4"><b>The structure of defaultParentEvent</b></p>
+<p class="p5"><br></p>
+<p class="p3">The default parent event provides the collection of default values and functions needed for the different uses of an Event. These<span class="Apple-converted-space"> </span>defaults are defined in partialEvents that specify distinct aspects of default parent Event:<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>playerEvent<span class="Apple-tab-span"> </span></b>defines ~play, ~type and ~eventTypes</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>serverEvent<span class="Apple-tab-span"> </span></b>server, group, addAction</p>
-<p class="p5"><span class="Apple-tab-span"> </span><b>durEvent<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>duration, tempo and articulation</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>ampEvent<span class="Apple-tab-span"> </span></b>volume, pan, MIDI velocity</p>
-<p class="p5"><span class="Apple-tab-span"> </span><b>pitchEvent<span class="Apple-tab-span"> </span></b>pitch specified in many different ways</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>bufferEvent<span class="Apple-tab-span"> </span></b>buffers on the server</p>
-<p class="p5"><b><span class="Apple-tab-span"> </span>midiEvent<span class="Apple-tab-span"> </span></b>midi</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>playerEvent<span class="Apple-tab-span"> </span></b>defines ~play, ~type and ~eventTypes</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>serverEvent<span class="Apple-tab-span"> </span></b>server, group, addAction</p>
+<p class="p3"><span class="Apple-tab-span"> </span><b>durEvent<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>duration, tempo and articulation</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>ampEvent<span class="Apple-tab-span"> </span></b>volume, pan, MIDI velocity</p>
+<p class="p3"><span class="Apple-tab-span"> </span><b>pitchEvent<span class="Apple-tab-span"> </span></b>pitch specified in many different ways</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>bufferEvent<span class="Apple-tab-span"> </span></b>buffers on the server</p>
+<p class="p3"><b><span class="Apple-tab-span"> </span>midiEvent<span class="Apple-tab-span"> </span></b>midi</p>
<p class="p2"><span class="Apple-tab-span"> </span></p>
-<p class="p3"><b>Useful keys for notes</b></p>
+<p class="p4"><b>Useful keys for notes</b></p>
<p class="p2"><br></p>
-<p class="p5">Using Events is largely a matter of overwriting keys.<span class="Apple-converted-space"> </span>Here is a list of keys useful for defining notes with their default values, grouped by the partialEvent within which they are defined.</p>
+<p class="p3">Using Events is largely a matter of overwriting keys.<span class="Apple-converted-space"> </span>Here is a list of keys useful for defining notes with their default values, grouped by the partialEvent within which they are defined.</p>
<p class="p2"><br></p>
-<p class="p5">The keys in serverEvent provide the values needed to identify the server to be used and where in the tree</p>
-<p class="p5">of nodes to place the group. <span class="Apple-converted-space"> </span></p>
+<p class="p3">The keys in serverEvent provide the values needed to identify the server to be used and where in the tree</p>
+<p class="p3">of nodes to place the group. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
-<p class="p5">serverEvent keys:</p>
+<p class="p3">serverEvent keys:</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>server: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span><span class="s8">nil</span><span class="s3">,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// if nil, Server.default is used</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>instrument: <span class="Apple-tab-span"> </span></span><span class="s12">\default</span><span class="s3">,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// this is the name of a SynthDef</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>group: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>1,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// nodeID of group on the server</p>
@@ -235,16 +238,16 @@
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>addAction:<span class="Apple-tab-span"> </span>0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// 0, 1, 2, 3 or \addToHead, \addToTail, \addBefore, \addAfter</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>out: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// usually an output bus number, but depends on the SynthDef<span class="Apple-tab-span"> </span></p>
<p class="p8"><span class="Apple-tab-span"> </span></p>
-<p class="p5">The ampEvent determines volume.<span class="Apple-converted-space"> </span>Notice that <span class="s1">~amp</span> is a function that determines its value from <span class="s1">~db</span>. The user can choose to specify the amplitude directly by overwriting ~amp or to use a decibel specification by overwriting <span class="s1">~db</span>.</p>
+<p class="p3">The ampEvent determines volume.<span class="Apple-converted-space"> </span>Notice that <span class="s1">~amp</span> is a function that determines its value from <span class="s1">~db</span>. The user can choose to specify the amplitude directly by overwriting ~amp or to use a decibel specification by overwriting <span class="s1">~db</span>.</p>
<p class="p8"><br></p>
-<p class="p5">ampEvent keys:</p>
+<p class="p3">ampEvent keys:</p>
<p class="p9"><span class="Apple-tab-span"> </span>amp: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>#{ ~db.dbamp },</p>
<p class="p9"><span class="Apple-tab-span"> </span>db: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>-20.0,</p>
<p class="p9"><span class="Apple-tab-span"> </span>pan: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.0,<span class="Apple-converted-space"> <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span></p>
<p class="p2"><br></p>
-<p class="p5">The durEvent has keys that determine the timing of a note. Notice that <span class="s1">~sustain </span>is a function that uses ~legato to determine the sustain. Like <span class="s1">~amp </span>this can be overwritten to set the sustain directly.</p>
+<p class="p3">The durEvent has keys that determine the timing of a note. Notice that <span class="s1">~sustain </span>is a function that uses ~legato to determine the sustain. Like <span class="s1">~amp </span>this can be overwritten to set the sustain directly.</p>
<p class="p2"><br></p>
-<p class="p5">durEvent keys:</p>
+<p class="p3">durEvent keys:</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>tempo:<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span><span class="s8">nil</span><span class="s3">,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// changes tempo of a TempoClock</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>dur: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>1.0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// delay until next note</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>stretch: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>1.0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// inverse of tempo control, specific to the Event's stream</p>
@@ -253,23 +256,23 @@
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>lag: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// delay relative to current time position of Stream</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>strum: <span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.0<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// "breaks" a chord</p>
<p class="p2"><br></p>
-<p class="p5">The pitchEvent has the most complex system of functions that provide a variety of useful ways to determine</p>
-<p class="p5">pitch:</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~freq<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines the pitch directly as a frequency in Hertz</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~midinote<span class="Apple-tab-span"> </span></span>determines pitch as a fractional MIDI note (69 -> 440)</p>
-<p class="p5"><span class="s1"><span class="Apple-tab-span"> </span>~note<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines pitch as a scale degree in an <span class="s1">~stepsPerOctave </span>equal tempered scale</p>
-<p class="p5"><span class="s1"><span class="Apple-tab-span"> </span>~degree<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines pitch as a scale degree within the scale <span class="s1">~scale</span></p>
+<p class="p3">The pitchEvent has the most complex system of functions that provide a variety of useful ways to determine</p>
+<p class="p3">pitch:</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~freq<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines the pitch directly as a frequency in Hertz</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~midinote<span class="Apple-tab-span"> </span></span>determines pitch as a fractional MIDI note (69 -> 440)</p>
+<p class="p3"><span class="s1"><span class="Apple-tab-span"> </span>~note<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines pitch as a scale degree in an <span class="s1">~stepsPerOctave </span>equal tempered scale</p>
+<p class="p3"><span class="s1"><span class="Apple-tab-span"> </span>~degree<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>determines pitch as a scale degree within the scale <span class="s1">~scale</span></p>
<p class="p2"><br></p>
-<p class="p5">The event also provides a set of transposition keys:</p>
+<p class="p3">The event also provides a set of transposition keys:</p>
<p class="p2"><br></p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~mtranspose<span class="Apple-tab-span"> </span></span>modal transposition of degree within a scale</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~root</span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>transposes root of the scale<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~gtranspose<span class="Apple-tab-span"> </span></span>gamut transposition within the<span class="s1">~stepsPerOctave</span> equal tempered scale</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~ctranspose<span class="Apple-tab-span"> </span></span>chromatic transposition within the 12 tone equal tempered scale</p>
-<p class="p5"><span class="Apple-tab-span"> </span><span class="s1">~harmonic<span class="Apple-tab-span"> </span></span>multiplies the frequency determined by <span class="s1">~midinote</span>, typically to an overtone</p>
-<p class="p5"><span class="Apple-tab-span"> </span>~detune<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>directly alters frequency</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~mtranspose<span class="Apple-tab-span"> </span></span>modal transposition of degree within a scale</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~root</span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>transposes root of the scale<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~gtranspose<span class="Apple-tab-span"> </span></span>gamut transposition within the<span class="s1">~stepsPerOctave</span> equal tempered scale</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~ctranspose<span class="Apple-tab-span"> </span></span>chromatic transposition within the 12 tone equal tempered scale</p>
+<p class="p3"><span class="Apple-tab-span"> </span><span class="s1">~harmonic<span class="Apple-tab-span"> </span></span>multiplies the frequency determined by <span class="s1">~midinote</span>, typically to an overtone</p>
+<p class="p3"><span class="Apple-tab-span"> </span>~detune<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>directly alters frequency</p>
<p class="p2"><br></p>
-<p class="p5">pitchEvent keys:</p>
+<p class="p3">pitchEvent keys:</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>mtranspose: <span class="Apple-tab-span"> </span>0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// modal transposition of degree</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>gtranspose: <span class="Apple-tab-span"> </span>0.0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// gamut transposition of note within a ~stepsPerOctave e.t. scale</p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>ctranspose: <span class="Apple-tab-span"> </span>0.0,<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// chromatic transposition of midinote within 12 tone e.t. scale</p>
@@ -292,21 +295,21 @@
<p class="p9"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>(~midinote.value + ~ctranspose).midicps * ~harmonic;</p>
<p class="p9"><span class="Apple-tab-span"> </span>},</p>
<p class="p2"><br></p>
-<p class="p3"><b>Event types</b></p>
+<p class="p4"><b>Event types</b></p>
<p class="p2"><br></p>
-<p class="p5">An Event responds to a play message by evaluating ~play in the event Here is a slightly simplified version of the default definition of<span class="Apple-converted-space"> </span><span class="s1">~play:</span></p>
+<p class="p3">An Event responds to a play message by evaluating ~play in the event Here is a slightly simplified version of the default definition of<span class="Apple-converted-space"> </span><span class="s1">~play:</span></p>
<p class="p2"><br></p>
<p class="p9"><span class="Apple-tab-span"> </span>{ <span class="Apple-tab-span"> </span>~eventTypes[~type].value(server); },</p>
-<p class="p4"><br></p>
-<p class="p5">The function uses the value of <span class="s9">~</span><span class="s1">type</span><span class="s9"> </span>to select a function from the dictionary held in <span class="s9">~</span><span class="s1">eventTypes</span><span class="s9">.</span> The collection of eventTypes can be readily extended using <b>*addEventType(key, function)</b>. <span class="Apple-converted-space"> </span></p>
+<p class="p5"><br></p>
+<p class="p3">The function uses the value of <span class="s9">~</span><span class="s1">type</span><span class="s9"> </span>to select a function from the dictionary held in <span class="s9">~</span><span class="s1">eventTypes</span><span class="s9">.</span> The collection of eventTypes can be readily extended using <b>*addEventType(key, function)</b>. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
-<p class="p5">Here is an example the uses the event types<span class="Apple-converted-space"> </span><span class="s1">\group </span>and<span class="s1"> \note</span>:</p>
+<p class="p3">Here is an example the uses the event types<span class="Apple-converted-space"> </span><span class="s1">\group </span>and<span class="s1"> \note</span>:</p>
<p class="p2"><br></p>
<p class="p7"><span class="s3"><span class="Apple-tab-span"> </span>(type: </span><span class="s12">\group</span><span class="s3">, id: 2).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>// create a group with nodeID 2</p>
<p class="p9"><span class="Apple-tab-span"> </span>(type: <span class="s12">\note</span>, freq: 500, group: 2).play<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s4">// play a synth in that group</span></p>
<p class="p2"><br></p>
<p class="p2"><br></p>
-<p class="p5">Here is a listing of currently existing event types:</p>
+<p class="p3">Here is a listing of currently existing event types:</p>
<p class="p15"><span class="Apple-converted-space"> </span></p>
<p class="p9"><span class="Apple-converted-space"> </span>group<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>creates group, id must be specified</p>
<p class="p9"><span class="Apple-converted-space"> </span>note<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>instrument specifies synthdef</p>
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
_______________________________________________
sc-dev mailing list
info (subscription, etc.): http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
archive: https://listarc.bham.ac.uk/marchives/sc-dev/
search: https://listarc.bham.ac.uk/lists/sc-dev/search/