HelpSource/Classes/InTrig.schelp

   1 class:: InTrig
   2 summary:: Generate a trigger anytime a bus is set.
   3 categories::  UGens>InOut, UGens>Triggers
   4
   5
   6 Description::
   7
   8 Any time the bus is "touched" ie. has its value set (using "/c_set"
   9 etc.), a single impulse trigger will be generated. Its amplitude is the
  10 value that the bus was set to.
  11
  12 If the bus is set link::Classes/Bus#synchronous_control_bus_methods#synchrounosly:: no trigger will be generated.
  13
  14
  15 classmethods::
  16
  17 method::kr
  18
  19 argument::bus
  20 The index of the bus to read in from.
  21
  22 argument::numChannels
  23 The number of channels (i.e. adjacent buses) to read in. You
  24 cannot modulate this number by assigning it to an argument in a
  25 SynthDef.
  26
  27
  28 Examples::
  29
  30 code::
  31 s = Server.local;
  32 b = Bus.control(s,1);
  33
  34 SynthDef("help-InTrig",{arg out=0,busnum=0;
  35         var inTrig;
  36         inTrig = InTrig.kr( busnum );
  37         Out.ar(out,
  38                 EnvGen.kr(Env.perc,gate: inTrig,levelScale: inTrig ) * SinOsc.ar
  39         )
  40 }).play(s,[\out, 0, \busnum, b.index]);
  41
  42
  43 b.set(1.0);
  44
  45 b.value = 1.0;
  46
  47 b.value = 0.2;
  48
  49 b.value = 0.1;
  50 ::
  51
  52 compare with link::Classes/In:: example.
  53