supernova: allocators - fix construct method
[supercollider.git] / Help / Streams-Patterns-Events / Patterns / Pbinop.html
blob9b3b9a33dccbf8b67aaee775e9ad6d33e2ef30cf
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: 12.0px Helvetica; color: #0000ee}
13 p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; 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: #007300}
17 p.p8 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf}
18 span.s1 {font: 18.0px Helvetica}
19 span.s2 {color: #000000}
20 span.s3 {text-decoration: underline}
21 span.s4 {color: #0000ff}
22 span.s5 {color: #0000bf}
23 span.s6 {color: #007300}
24 span.Apple-tab-span {white-space:pre}
25 </style>
26 </head>
27 <body>
28 <p class="p1"><span class="s1"><b>Pbinop<span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span></b></span><b>binary operator pattern</b></p>
29 <p class="p2"><br></p>
30 <p class="p1">superclass: Pattern</p>
31 <p class="p2"><br></p>
32 <p class="p1"><b>Pbinop(operator, a, b)</b></p>
33 <p class="p2"><br></p>
34 <p class="p1">Returns a stream that applies the binary operator to the stream values of the receiver</p>
35 <p class="p1">Usually, this is the result of applying a binary operator (i.e. a method with one argument) to a pattern.</p>
36 <p class="p2"><br></p>
37 <p class="p1"><b>operator </b>- operator to be applied</p>
38 <p class="p1"><b>a</b> - a pattern (or compatible pattern input)</p>
39 <p class="p1"><b>b</b> -<span class="Apple-converted-space">  </span>a pattern (or compatible pattern input)</p>
40 <p class="p2"><br></p>
41 <p class="p1">examples of binary operators are: +, -, /, *, min, max, hypot ...</p>
42 <p class="p2"><br></p>
43 <p class="p3"><span class="s2"><b>See also: </b><a href="Pnaryop.html"><span class="s3">Pnaryop</span></a>, <a href="Punop.html"><span class="s4">Punop</span></a>, <a href="../../Core/BinaryOpFunction.html"><span class="s3">BinaryOpFunction</span></a></span></p>
44 <p class="p2"><br></p>
45 <p class="p4"><br></p>
46 <p class="p5">// example</p>
47 <p class="p4"><br></p>
48 <p class="p6">(</p>
49 <p class="p6"><span class="s5">var</span> a;</p>
50 <p class="p6">a = <span class="s5">Pbinop</span>(<span class="s6">\hypot</span>, <span class="s5">Pseries</span>(0, 1, 12), <span class="s5">Pseries</span>(3, -1, 12));</p>
51 <p class="p6">a.asStream.all;</p>
52 <p class="p6">)</p>
53 <p class="p4"><br></p>
54 <p class="p5">// this is the same as:</p>
55 <p class="p6">(</p>
56 <p class="p6"><span class="s5">var</span> a;</p>
57 <p class="p6">a = <span class="s5">Pseries</span>(0, 1, 12).hypot(<span class="s5">Pseries</span>(3, -1, 12));</p>
58 <p class="p6">a.asStream.all;</p>
59 <p class="p6">)</p>
60 <p class="p4"><br></p>
61 <p class="p5">// also written as:</p>
62 <p class="p6">(</p>
63 <p class="p6"><span class="s5">var</span> a;</p>
64 <p class="p6">a = <span class="s5">Pseries</span>(0, 1, 12) hypot: <span class="s5">Pseries</span>(3, -1, 12);</p>
65 <p class="p6">a.asStream.all;</p>
66 <p class="p6">)</p>
67 <p class="p4"><br></p>
68 <p class="p5">// some common cases:</p>
69 <p class="p6"><span class="s5">Pseq</span>([1, 2, 3]) + 2;</p>
70 <p class="p6"><span class="s5">Pseq</span>([1, 2, 3]) / <span class="s5">Pseq</span>([3, 4, 5, 6]);</p>
71 <p class="p6">max(<span class="s5">Pwhite</span>(-10, 10, <span class="s5">inf</span>), <span class="s5">Pseq</span>([0, 2, 3, 4]));</p>
72 <p class="p4"><br></p>
73 <p class="p5">// sound example</p>
74 <p class="p6">(</p>
75 <p class="p7"><span class="s5">SynthDef</span><span class="s2">(</span>\help_sinegrain<span class="s2">,<span class="Apple-converted-space"> </span></span></p>
76 <p class="p6"><span class="Apple-tab-span"> </span>{ <span class="s5">arg</span> out=0, freq=440, sustain=0.05, amp=0.1;</p>
77 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s5">var</span> env;</p>
78 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>env = <span class="s5">EnvGen</span>.kr(<span class="s5">Env</span>.perc(0.01, sustain, 0.2, amp), doneAction:2);</p>
79 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s5">Out</span>.ar(out, <span class="s5">SinOsc</span>.ar(freq, 0, env))</p>
80 <p class="p6"><span class="Apple-tab-span"> </span>}).add;</p>
81 <p class="p6">)</p>
82 <p class="p4"><br></p>
83 <p class="p4"><br></p>
84 <p class="p6">(</p>
85 <p class="p6"><span class="s5">var</span> a;</p>
86 <p class="p6">a = <span class="s5">Pn</span>(<span class="s5">Pbinop</span>(<span class="s6">\hypot</span>, <span class="s5">Pseries</span>(0, 1, 34), <span class="s5">Pseries</span>(3, -1, 34)), <span class="s5">inf</span>).asStream;</p>
87 <p class="p6">{</p>
88 <p class="p6"><span class="Apple-tab-span"> </span>a.do { <span class="s5">|val|</span></p>
89 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s5">Synth</span>(<span class="s6">\help_sinegrain</span>, [<span class="s6">\freq</span>, a * 200 + 300].postln);</p>
90 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.05.wait;</p>
91 <p class="p6"><span class="Apple-tab-span"> </span>}</p>
92 <p class="p6">}.fork;</p>
93 <p class="p6">)</p>
94 <p class="p4"><br></p>
95 <p class="p6">(</p>
96 <p class="p8">Pbind<span class="s2">(</span></p>
97 <p class="p6"><span class="Apple-tab-span"> </span><span class="s6">\dur</span>, 0.01,</p>
98 <p class="p7"><span class="s2"><span class="Apple-tab-span"> </span></span>\instrument<span class="s2">, </span>\help_sinegrain<span class="s2">,</span></p>
99 <p class="p6"><span class="Apple-tab-span"> </span><span class="s6">\note</span>, <span class="s5">Pn</span>(<span class="s5">Pbinop</span>(<span class="s6">\hypot</span>, <span class="s5">Pwhite</span>(0, 12, 13), <span class="s5">Pseries</span>(3, -1, 12)))</p>
100 <p class="p6">).play;</p>
101 <p class="p6">)</p>
102 <p class="p4"><br></p>
103 <p class="p4"><br></p>
104 <p class="p4"><br></p>
105 <p class="p5">// these are the same as:</p>
106 <p class="p4"><br></p>
107 <p class="p6">(</p>
108 <p class="p6"><span class="s5">var</span> a;</p>
109 <p class="p6">a = <span class="s5">Pn</span>(<span class="s5">Pseries</span>(0, 1, 34) hypot: <span class="s5">Pseries</span>(3, -1, 34), <span class="s5">inf</span>).asStream;</p>
110 <p class="p6">{</p>
111 <p class="p6"><span class="Apple-tab-span"> </span>a.do { <span class="s5">|val|</span></p>
112 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span><span class="s5">Synth</span>(<span class="s6">\help_sinegrain</span>, [<span class="s6">\freq</span>, a * 200 + 300].postln);</p>
113 <p class="p6"><span class="Apple-tab-span"> </span><span class="Apple-tab-span"> </span>0.05.wait;</p>
114 <p class="p6"><span class="Apple-tab-span"> </span>}</p>
115 <p class="p6">}.fork;</p>
116 <p class="p6">)</p>
117 <p class="p4"><br></p>
118 <p class="p4"><br></p>
119 <p class="p6">(</p>
120 <p class="p8">Pbind<span class="s2">(</span></p>
121 <p class="p6"><span class="Apple-tab-span"> </span><span class="s6">\dur</span>, 0.01,</p>
122 <p class="p7"><span class="s2"><span class="Apple-tab-span"> </span></span>\instrument<span class="s2">, </span>\help_sinegrain<span class="s2">,</span></p>
123 <p class="p6"><span class="Apple-tab-span"> </span><span class="s6">\note</span>, <span class="s5">Pn</span>(<span class="s5">Pwhite</span>(0, 12, 13) hypot: <span class="s5">Pseries</span>(3, -1, 12))</p>
124 <p class="p6">).play;</p>
125 <p class="p6">)</p>
126 <p class="p4"><br></p>
127 </body>
128 </html>