HelpSource/Classes/TWChoose.schelp

   1 class:: TWChoose
   2 summary:: Randomly select one of several inputs
   3 categories:: UGens>Triggers, UGens>Random
   4 related:: Classes/TChoose
   5
   6 description::
   7 An output is selected randomly on recieving a trigger from an array of inputs.
   8
   9 the code::weights:: of this choice are determined from the weights array.
  10
  11 If code::normalize:: is set to 1 the weights are continuously normalized (this is an extra overhead) when using fixed values the code::normalizeSum:: method can be used to normalize the values.
  12
  13 TWChoose is a composite of link::Classes/TWindex:: and link::Classes/Select::.
  14
  15 classmethods::
  16 method:: ar, kr
  17
  18 argument:: trig
  19 argument:: array
  20 argument:: weights
  21 argument:: normalize
  22
  23 examples::
  24 code::
  25 (
  26 {
  27         var a;
  28         a = [
  29                         SinOsc.ar,
  30                         Saw.ar,
  31                         Pulse.ar
  32                 ];
  33         TWChoose.ar(Dust.ar(MouseX.kr(1, 1000, 1)), a, [0.99, 0.05, 0.05].normalizeSum) * 0.2
  34
  35 }.play;
  36 )
  37 ::
  38
  39 note:: all the ugens are continously running. This may not be the most efficient way if each input is  cpu-expensive.::