supernova: allocators - fix construct method
[supercollider.git] / Help / Streams-Patterns-Events / Patterns / Pgpar.html
blob6d9cdc3fb08812de5a8d05f9b0b7f864e7321023
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <meta http-equiv="Content-Style-Type" content="text/css">
6 <title></title>
7 <meta name="Generator" content="Cocoa HTML Writer">
8 <meta name="CocoaVersion" content="1038.25">
9 <style type="text/css">
10 p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
11 p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
12 p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
13 p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000; min-height: 12.0px}
14 p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
15 p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
16 p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf}
17 p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #007300}
18 span.s1 {font: 18.0px Helvetica}
19 span.s2 {color: #0000bf}
20 span.s3 {color: #007300}
21 span.s4 {color: #000000}
22 span.Apple-tab-span {white-space:pre}
23 </style>
24 </head>
25 <body>
26 <p class="p1"><span class="s1"><b>Pgpar<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></span><b>embed event streams in parallel and put each in its own group</b></p>
27 <p class="p2"><br></p>
28 <p class="p1"><b>superclass: Ppar</b></p>
29 <p class="p2"><br></p>
30 <p class="p1">Embeds several event streams so that they form a single output stream with all their events in temporal order.</p>
31 <p class="p1">When one stream ends, the other streams are further embedded until all have ended.</p>
32 <p class="p2"><br></p>
33 <p class="p1"><b>Pgpar(list, repeats)</b></p>
34 <p class="p2"><b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b></p>
35 <p class="p1"><b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>list:<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>list of patterns or streams</p>
36 <p class="p1"><b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>repeats:<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b>repeat the whole pattern n times (default: 1)</p>
37 <p class="p2"><br></p>
38 <p class="p3"><br></p>
39 <p class="p1">In order to fully separate these layers from other synths, use <a href="Pbus.html"><span class="s2">Pbus</span></a>.</p>
40 <p class="p2"><br></p>
41 <p class="p1">See <a href="Pgroup.html"><span class="s2">Pgroup</span></a> for a description of the \groupReleaseTime event key.</p>
42 <p class="p4"><br></p>
43 <p class="p3"><br></p>
44 <p class="p3"><br></p>
45 <p class="p5">// an example analogous to the one in the Pfx helpfile</p>
46 <p class="p3"><br></p>
47 <p class="p6">(</p>
48 <p class="p6"><span class="s2">SynthDef</span>(<span class="s3">\echo</span>, { <span class="s2">arg</span> out=0, maxdtime=0.2, dtime=0.2, decay=2, gate=1;</p>
49 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">var</span> env, in;</p>
50 <p class="p6"><span class="Apple-tab-span"> </span>env = <span class="s2">Linen</span>.kr(gate, 0.05, 1, 0.1, 2);</p>
51 <p class="p6"><span class="Apple-tab-span"> </span>in = <span class="s2">In</span>.ar(out, 2);</p>
52 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">XOut</span>.ar(out, env, <span class="s2">CombL</span>.ar(in * env, maxdtime, dtime, decay, 1, in));</p>
53 <p class="p6">}, [<span class="s3">\ir</span>, <span class="s3">\ir</span>, 0.1, 0.1, 0]).add;</p>
54 <p class="p3"><br></p>
55 <p class="p6"><span class="s2">SynthDef</span>(<span class="s3">\distort</span>, { <span class="s2">arg</span> out=0, pregain=40, amp=0.2, gate=1;</p>
56 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">var</span> env;</p>
57 <p class="p6"><span class="Apple-tab-span"> </span>env = <span class="s2">Linen</span>.kr(gate, 0.05, 1, 0.1, 2);</p>
58 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">XOut</span>.ar(out, env, (<span class="s2">In</span>.ar(out, 2) * pregain).distort * amp);</p>
59 <p class="p6">}, [<span class="s3">\ir</span>, 0.1, 0.1, 0]).add;</p>
60 <p class="p3"><br></p>
61 <p class="p6"><span class="s2">SynthDef</span>(<span class="s3">\wah</span>, { <span class="s2">arg</span> out=0, gate=1, rate=0.3;</p>
62 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">var</span> env, in;</p>
63 <p class="p6"><span class="Apple-tab-span"> </span>env = <span class="s2">Linen</span>.kr(gate, 0.05, 1, 0.4, 2);</p>
64 <p class="p6"><span class="Apple-tab-span"> </span>in = <span class="s2">In</span>.ar(out, 2);</p>
65 <p class="p6"><span class="Apple-tab-span"> </span><span class="s2">XOut</span>.ar(out, env, <span class="s2">RLPF</span>.ar(in, <span class="s2">LinExp</span>.kr(<span class="s2">LFNoise1</span>.kr(rate), -1, 1, 200, 8000), 0.1).softclip * 0.8);</p>
66 <p class="p6">}, [<span class="s3">\ir</span>, 0]).add;</p>
67 <p class="p6">)</p>
68 <p class="p3"><br></p>
69 <p class="p3"><br></p>
70 <p class="p6">(</p>
71 <p class="p6"><span class="s2">var</span> p, q, r, o;</p>
72 <p class="p7">Pbus<span class="s4">(</span></p>
73 <p class="p7"><span class="s4"><span class="Apple-tab-span"> </span></span>Pgpar<span class="s4">([</span></p>
74 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">Pbind</span>(<span class="s3">\degree</span>, <span class="s2">Prand</span>((0..7), <span class="s2">inf</span>), <span class="s3">\dur</span>, 0.3, <span class="s3">\legato</span>, 0.2),</p>
75 <p class="p8"><span class="s4"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span><span class="s2">Pbind</span><span class="s4">(</span>\instrument<span class="s4">, </span>\echo<span class="s4">, </span>\dur<span class="s4">, 3, </span>\legato<span class="s4">, 1.1,<span class="Apple-converted-space"> </span></span></p>
76 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\dtime</span>, <span class="s2">Pwhite</span>(0.01, 0.1, <span class="s2">inf</span>), <span class="s3">\decay</span>, 3),</p>
77 <p class="p8"><span class="s4"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span><span class="s2">Pbind</span><span class="s4">(</span>\instrument<span class="s4">, </span>\distort<span class="s4">, </span>\dur<span class="s4">, 1.2, </span>\legato<span class="s4">, 1.1,<span class="Apple-converted-space"> </span></span></p>
78 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\pregain</span>, <span class="s2">Pwhite</span>(1, 20, <span class="s2">inf</span>), <span class="s3">\amp</span>, 0.25),</p>
79 <p class="p8"><span class="s4"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span><span class="s2">Pbind</span><span class="s4">(</span>\instrument<span class="s4">, </span>\wah<span class="s4">, </span>\dur<span class="s4">, 4.0, </span>\legato<span class="s4">, 1.1,<span class="Apple-converted-space"> </span></span></p>
80 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\rate</span>, <span class="s2">Pwhite</span>(0.1, 3, <span class="s2">inf</span>))</p>
81 <p class="p6"><span class="Apple-tab-span"> </span>])</p>
82 <p class="p6">).play</p>
83 <p class="p6">)</p>
84 <p class="p3"><br></p>
85 <p class="p3"><br></p>
86 <p class="p3"><br></p>
87 <p class="p5">// synthdefs</p>
88 <p class="p6">(</p>
89 <p class="p6"><span class="s2">SynthDef</span>(<span class="s3">\gap</span>, { <span class="s2">arg</span> out, sustain=1.0, attack=0.0001, decay=0.01, leak;</p>
90 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">var</span> level;</p>
91 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>level = <span class="s2">EnvGen</span>.ar(<span class="s2">Env</span>.linen(attack, sustain, decay, 1-leak), doneAction:2);</p>
92 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">XOut</span>.ar(out, level, <span class="s2">Silent</span>.ar ! 2)</p>
93 <p class="p6">}).add;</p>
94 <p class="p3"><br></p>
95 <p class="p8"><span class="s2">SynthDef</span><span class="s4">(</span>\help_sinegrain<span class="s4">,<span class="Apple-converted-space"> </span></span></p>
96 <p class="p6"><span class="Apple-tab-span"> </span>{ <span class="s2">arg</span> out=0, freq=440, sustain=0.05;</p>
97 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">var</span> env;</p>
98 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>env = <span class="s2">EnvGen</span>.kr(<span class="s2">Env</span>.perc(0.01, sustain, 0.2), doneAction:2);</p>
99 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">Out</span>.ar(out, <span class="s2">SinOsc</span>.ar(freq, 0, env))</p>
100 <p class="p6">}).add;</p>
101 <p class="p6">)</p>
102 <p class="p3"><br></p>
103 <p class="p3"><br></p>
104 <p class="p5">// play a layered pattern with gaps and overlays</p>
105 <p class="p6">(</p>
106 <p class="p6">x = <span class="s2">Pbind</span>(</p>
107 <p class="p8"><span class="s4"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>\instrument<span class="s4">, </span>\help_sinegrain<span class="s4">,</span></p>
108 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\degree</span>, <span class="s2">Pn</span>(<span class="s2">Plazy</span>({ <span class="s2">Prand</span>([0, 4, 5], 16) + 5.rand })) + <span class="s2">Prand</span>(#[0, [0, 3], [0, 7]], <span class="s2">inf</span>),</p>
109 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\dur</span>, <span class="s2">Prand</span>([0.25, 0.5, 1.0], <span class="s2">inf</span>),</p>
110 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\scale</span>, #[0, 3, 5, 9, 10]</p>
111 <p class="p6"><span class="Apple-tab-span"> </span>);</p>
112 <p class="p6">y = <span class="s2">Pbind</span>(</p>
113 <p class="p8"><span class="s4"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></span>\instrument<span class="s4">, </span>\gap<span class="s4">,</span></p>
114 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\dur</span>, <span class="s2">Prand</span>([0.25, 0.5, 1.0], <span class="s2">inf</span>) * <span class="s2">Pstutter</span>(<span class="s2">inf</span>, <span class="s2">Prand</span>([0.25, 1, 2],1)),</p>
115 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\legato</span>, <span class="s2">Prand</span>([0.25, 0.5, 1.0], <span class="s2">inf</span>),</p>
116 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s3">\leak</span>, 0.25</p>
117 <p class="p6"><span class="Apple-tab-span"> </span>);</p>
118 <p class="p6">a = <span class="s2">Pbus</span>(<span class="s2">Pgpar</span>([x, y, x, y, x, y]));</p>
119 <p class="p6">a.play;</p>
120 <p class="p6">)</p>
121 <p class="p3"><br></p>
122 </body>
123 </html>