Added help for Pen and updated some other docs
[supercollider.git] / HelpSource / Classes / Pswitch.schelp
blob6815479c55f1bf8a2005f1a906f1bb8669b94e3b
1 class:: Pswitch
2 summary:: embed values in a list according to a pattern of indices
3 related:: Classes/Pswitch1
4 categories:: Streams-Patterns-Events>Patterns>List>Indexing
6 ClassMethods::
8 method::new
9 Pswitch chooses elements from the strong::list:: by a stream of indices ( strong::which:: ) and embeds them in the stream. If the element is itself a pattern, it first completely embeds it before looking for the next index.
11 Examples::
13 code::
15 var a, b;
16 a = Pseq([1, 2, 3], 2);
17 b = Pseq([65, 76]);
18 c = Pswitch([a, b, 800], Pseq([2, 2, 0, 1], inf));
19 x = c.asStream;
20 24.do({ x.next.postln; });
24 //Pswitch used as a sequence of pitches:
27 SynthDef(\help_sinegrain,
28         { arg out=0, freq=440, sustain=0.05;
29                 var env;
30                 env = EnvGen.kr(Env.perc(0.01, sustain, 0.2), doneAction:2);
31                 Out.ar(out, SinOsc.ar(freq, 0, env))
32         }).add;
36 a = Pseq([73, 71, 69], 2);
37 b = Pseq([0, 0, 0, 4, 0]+64);
38 c = Pswitch([a, b, 75], Pseq([2, 2, 0, 1], inf));
39 x = c.asStream;
40 Routine({
41         loop({
42                 Synth(\help_sinegrain, [\freq, x.next.midicps]);
43                 0.18.wait;
44         })
45 }).play;