HelpSource/Classes/Pbindf.schelp

   1 class:: Pbindf
   2 summary:: bind several value patterns to one existing event stream by binding keys to valueskeys to values
   3 related:: Classes/Pattern, Classes/Event, Classes/Pbind, Classes/Pchain
   4 categories:: Streams-Patterns-Events>Patterns>Composition
   5
   6 description::
   7
   8 Pbindf adds several value streams into one existing event stream. Each value stream is assigned to one or more keys in the resulting event stream, overriding any values from the input stream.
   9
  10 The patterns bound to keys are referred to as value patterns and the Pbindf itself is termed an emphasis::event pattern::.
  11
  12 ClassMethods::
  13
  14 method::new
  15 The arguments to Pbindf is the initial pattern followed by an alternating sequence of keys and patterns. A pattern can also be bound to an array of keys. In this case, the pattern must specify a sequence whose elements are arrays with at least as many elements as there are keys.
  16
  17 Examples::
  18
  19 code::
  20 (
  21 a = Pbind(\x, Pseq([1, 2, 3]), \zzz, 9000); // input stream
  22 b = Pbindf(a, \y, Prand([100, 300, 200], inf), \zzz, 99);
  23 x = b.asStream;
  24 )
  25
  26 x.next(()); // pass in an event ()
  27 x.next(());
  28 x.next(());
  29 x.next(()); // end: nil
  30
  31
  32
  33 // sound examples
  34
  35 // using the default synth def
  36 a = Pbind(\dur, 0.1);
  37 Pbindf(a, \freq, Prand([300, 500, 231.2, 399.2], inf)).play;
  38 Pbindf(a, \freq, Prand([1, 1.2, 2, 2.5, 3, 4], inf) * 200).play;
  39
  40
  41 (
  42 // a SynthDef
  43 SynthDef(\test, { | out, freq = 440, amp = 0.1, nharms = 10, pan = 0, gate = 1 |
  44         var audio = Blip.ar(freq, nharms, amp);
  45         var env = Linen.kr(gate, doneAction: 2);
  46         OffsetOut.ar(out, Pan2.ar(audio, pan, env) );
  47 }).add;
  48 )
  49
  50 a = Pbind(\instrument, \test, \dur, 0.1);
  51
  52 Pbindf(a, \freq, Prand([1, 1.2, 2, 2.5, 3, 4], inf) * 200).play;
  53 ::