supernova: allocators - fix construct method
[supercollider.git] / Help / Streams-Patterns-Events / Patterns / Pclutch.html
blob26428ae5d3a7906676adcb62181076a98cb37b54
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: 12.0px Helvetica; color: #0000bf}
14 p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000; min-height: 12.0px}
15 p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
16 p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
17 p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #007300}
18 p.p9 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf}
19 span.s1 {font: 18.0px Helvetica}
20 span.s2 {color: #0000bf}
21 span.s3 {color: #000000}
22 span.s4 {text-decoration: underline}
23 span.s5 {color: #007300}
24 span.Apple-tab-span {white-space:pre}
25 </style>
26 </head>
27 <body>
28 <p class="p1"><span class="s1"><b>Pclutch</b></span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><b>sample and hold a pattern</b></p>
29 <p class="p2"><br></p>
30 <p class="p1">superclass: FilterPattern</p>
31 <p class="p2"><br></p>
32 <p class="p2"><br></p>
33 <p class="p1"><b>Pclutch(pattern, connected)</b></p>
34 <p class="p2"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
35 <p class="p1"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><b>pattern</b> - any pattern</p>
36 <p class="p1"><b><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>connected - </b>a pattern that returns either a series of [<a href="../../Core/Boolean.html"><span class="s2">Boolean</span></a><span class="s2">s</span>] or the equivalent 0 and 1.</p>
37 <p class="p1"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>if true (or 1), the pattern plays as usual, if false (or 0), the previous value is kept.<span class="Apple-tab-span"> </span></p>
38 <p class="p3"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></p>
39 <p class="p2"><br></p>
40 <p class="p4"><span class="s3"><b>see also</b>: <a href="../StreamClutch.html"><span class="s4">StreamClutch</span></a>, <a href="Pstutter.html"><span class="s4">Pstutter</span></a>, <a href="../../UGens/Synth control/Latch.html"><span class="s4">Latch</span></a></span></p>
41 <p class="p5"><br></p>
42 <p class="p3"><br></p>
43 <p class="p3"><br></p>
44 <p class="p6">// example:</p>
45 <p class="p3"><br></p>
46 <p class="p7"><span class="s2">Pclutch</span>(<span class="s2">Pseq</span>([1, 2, 3, 4, 5], 3), <span class="s2">Pseq</span>([0, 0, 1, 0, 0, 0, 1, 1])).asStream.nextN(10);</p>
47 <p class="p3"><br></p>
48 <p class="p6">// sound example</p>
49 <p class="p7">(</p>
50 <p class="p8"><span class="s2">SynthDef</span><span class="s3">(</span>\help_sinegrain<span class="s3">,<span class="Apple-converted-space"> </span></span></p>
51 <p class="p7"><span class="Apple-tab-span"> </span>{ <span class="s2">arg</span> out=0, freq=440, sustain=0.05;</p>
52 <p class="p7"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">var</span> env;</p>
53 <p class="p7"><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>
54 <p class="p7"><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>
55 <p class="p7"><span class="Apple-tab-span"> </span>}).add;</p>
56 <p class="p7">)</p>
57 <p class="p3"><br></p>
58 <p class="p3"><br></p>
59 <p class="p7">(</p>
60 <p class="p7"><span class="s2">var</span> a;</p>
61 <p class="p9"><span class="s3">a = </span>Pclutch<span class="s3">(</span></p>
62 <p class="p7"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">Pseq</span>([1, 2, 3, 4, 5], <span class="s2">inf</span>),<span class="Apple-converted-space"> </span></p>
63 <p class="p7"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">Pseq</span>([0, 0, 1, 0, <span class="s2">Pn</span>(0, {30.rand}), 0, 1, 1], <span class="s2">inf</span>)</p>
64 <p class="p7"><span class="Apple-tab-span"> </span>).asStream;</p>
65 <p class="p7">{</p>
66 <p class="p7"><span class="Apple-tab-span"> </span>loop {</p>
67 <p class="p7"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s2">Synth</span>(<span class="s5">\help_sinegrain</span>, [<span class="s5">\freq</span>, a.next * 200 + 200]);</p>
68 <p class="p7"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.02.wait;</p>
69 <p class="p7"><span class="Apple-tab-span"> </span>}</p>
70 <p class="p7">}.fork;</p>
71 <p class="p7">)</p>
72 <p class="p3"><br></p>
73 <p class="p3"><br></p>
74 <p class="p3"><br></p>
75 </body>
76 </html>