HelpSource/Classes/Pfunc.schelp

   1 class:: Pfunc
   2 summary:: Function pattern
   3 categories:: Streams-Patterns-Events>Patterns>Function
   4 related:: Classes/Pfuncn
   5
   6 description::
   7 Returns a link::Classes/Stream:: that returns values from the code::nextFunc::.
   8
   9
  10 classmethods::
  11
  12 method:: new
  13 argument:: nextFunc
  14 Stream function. In an event stream receives the current link::Classes/Event:: as argument.
  15 argument:: resetFunc
  16 Function that is called when the stream is reset. In an event stream receives the current link::Classes/Event:: as argument.
  17
  18
  19 examples::
  20 code::
  21 (
  22 var a, x;
  23 a = Pfunc({ exprand(0.1, 2.0) + #[1, 2, 3, 6].choose }, { \reset.postln });
  24 x = a.asStream;
  25 x.nextN(20).postln;
  26 x.reset;
  27 )
  28 ::
  29
  30 Sound example
  31 code::
  32 (
  33 SynthDef(\help_sinegrain,
  34         { arg out = 0, freq = 440, sustain = 0.05;
  35                 var env;
  36                 env = EnvGen.kr(Env.perc(0.01, sustain, 0.2), doneAction:2);
  37                 Out.ar(out, SinOsc.ar(freq, 0, env))
  38         }).add;
  39 )
  40
  41 (
  42 var a;
  43 a = Pfunc({ exprand(0.1, 0.3) + #[1, 2, 3, 6, 7].choose }).asStream;
  44 {
  45         a.do { |val|
  46                 Synth(\help_sinegrain, [\freq, val * 100 + 300]);
  47                 0.02.wait;
  48         }
  49 }.fork;
  50 )
  51 ::