HelpSource/Classes/Pseed.schelp

   1 class:: Pseed
   2 summary:: set the random seed in subpattern
   3 related:: Reference/randomSeed
   4 categories:: Streams-Patterns-Events>Patterns>Language Control
   5
   6 description::
   7
   8 Set the random generator seed of the resulting stream.
   9
  10 ClassMethods::
  11
  12 method::new
  13
  14 argument::randSeed
  15 integer number, pattern or stream that return an integer number.
  16
  17 note::
  18 randSeed is always treated as a pattern/stream. If you provide a single, constant seed value, it will behave as an infinite-length stream. This will cause the subpattern to be embedded an infinite number of times. Compare:
  19
  20 code::
  21 // Pwhite repeats its three values forever
  22 Pseed(1000, Pwhite(1, 10, 3)).asStream.nextN(10);
  23
  24 // Pwhite runs once:
  25 // the output stream consists of three values, then 'nil' ad infinitum
  26 Pseed(Pn(1000, 1), Pwhite(1, 10, 3)).asStream.nextN(10);
  27 ::
  28 ::
  29
  30 argument::pattern
  31
  32 Examples::
  33
  34 code::
  35 a = Pseed(1972, Prand([1,2,3], inf));
  36
  37 b = a.asStream;
  38 10.do({ b.next.post });
  39
  40 c = a.asStream;
  41 10.do({ c.next.post });
  42
  43
  44 // using a seed pattern as input:
  45
  46 a = Pseed(Pseq([1812, 1912], inf), Prand([1,2,3], 5));
  47
  48 b = a.asStream;
  49 2.do({ 5.do({ b.next.post });"".postln;  });
  50
  51 c = a.asStream;
  52 2.do({ 5.do({ c.next.post });"".postln;  });
  53
  54
  55 // outer thread is independant:
  56
  57 a = Pseed(Prand([1534, 1600, 1798, 1986, 2005], inf), Pshuf([1, Prand([7, 9], 2), 1, 2, 3], 1));
  58
  59 // returns random streams
  60 b = a.asStream;
  61 2.do({ 5.do({ b.next.post });"".postln;  });
  62
  63 c = a.asStream;
  64 2.do({ 5.do({ c.next.post });"".postln;  });
  65 ::