Merge pull request #506 from andrewcsmith/patch-2
[supercollider.git] / HelpSource / Classes / Pxrand.schelp
blob58f48c89be80d52caf899481eab0b3a394f042d4
1 class:: Pxrand
2 summary:: embed values randomly chosen from a list
3 related:: Classes/Prand, Classes/Pwrand
4 categories:: Streams-Patterns-Events>Patterns>List
6 description::
7 Like link::Classes/Prand::, returns one item from the list at random for each repeat, but Pxrand never repeats the same element twice in a row.
9 Examples::
11 code::
13 var a, b;
14 a = Pxrand.new(#[1, 2, 3], 10); // return 10 items
15 b = a.asStream;
16 11.do({ b.next.postln; });
19 //Pxrand used as a sequence of pitches:
22 SynthDef(\help_sinegrain,
23         { arg out=0, freq=440, sustain=0.05;
24                 var env;
25                 env = EnvGen.kr(Env.perc(0.01, sustain, 0.2), doneAction:2);
26                 Out.ar(out, SinOsc.ar(freq, 0, env))
27         }).add;
32 a = Pxrand(#[60, 61, 63, 65, 72], inf).asStream;
33 Routine({
34         loop({
35                 Synth(\help_sinegrain, [\freq, a.next.midicps]);
36                 0.1.wait;
37         })
38 }).play;