HelpSource/Classes/Pset.schelp

   1 class:: Pset
   2 summary:: event pattern that sets values of one key
   3 related:: Classes/Pbindf, Classes/Psetp
   4 categories:: Streams-Patterns-Events>Patterns>Filter
   5
   6 description::
   7
   8 Pset sets a value in an event stream. It acts like one key in a link::Classes/Pbindf::.
   9 code::
  10 (
  11 var a, b;
  12 a = Pset(\freq, 801, Pbind(\dur, 0.5));
  13 x = a.asStream;
  14 9.do({ x.next(Event.new).postln; });
  15 )
  16 ::
  17
  18 ClassMethods::
  19
  20 method::new
  21
  22 argument::name
  23 the key.
  24
  25 argument::value
  26 can be a pattern or a stream. The resulting stream ends when that incoming stream ends.
  27
  28 argument::pattern
  29 the pattern.
  30
  31 Examples::
  32
  33 code::
  34 //Pset overrides incoming values:
  35
  36 (
  37 var a, b;
  38 a = Pset(\freq, 801, Pbind(\freq, 108));
  39 x = a.asStream;
  40 9.do({ x.next(Event.new).postln; });
  41 )
  42
  43
  44 (
  45 var a, b;
  46 a = Pset(\freq, Pseq([401, 801], 2), Pbind(\dur, 0.5));
  47 x = a.asStream;
  48 9.do({ x.next(Event.new).postln; });
  49 )
  50
  51
  52 //sound example
  53
  54 (
  55 SynthDef(\sinegrain,
  56         { arg out=0, freq=440, sustain=0.02;
  57                 var env;
  58                 env = EnvGen.kr(Env.perc(0.001, sustain), 1, doneAction:2);
  59                 Out.ar(out, SinOsc.ar(freq, 0, env * 0.1))
  60         }).add;
  61 )
  62
  63 (
  64 a = Pbind(\dur, 0.5, \instrument, \sinegrain);
  65 a = Pset(\freq, Pseq([500, 600, 700], inf), a);
  66 a = Pset(\legato, Pseq([0.01, 1],inf), a);
  67 a.play;
  68 )
  69 ::