HelpSource/Classes/TIRand.schelp

   1 class:: TIRand
   2 summary:: Triggered integer random number generator.
   3 related:: Classes/ExpRand, Classes/IRand, Classes/LinRand, Classes/NRand, Classes/Rand, Classes/TExpRand, Classes/TRand
   4 categories:: UGens>Random, UGens>Triggers
   5
   6
   7 Description::
   8
   9 Generates a random integer value in uniform distribution from
  10 code::lo::  to  code::hi::  each time the
  11 trigger signal changes from nonpositive to positive values.
  12
  13
  14 classmethods::
  15
  16 method::ar, kr
  17
  18 argument::lo
  19 Lower limit of the output range.
  20
  21 argument::hi
  22 Upper limit of the output range.
  23
  24 argument::trig
  25
  26 The trigger. Trigger can be any signal. A trigger happens when
  27 the signal changes from non-positive to positive.
  28
  29
  30 Examples::
  31
  32 code::
  33
  34 (
  35 SynthDef("help-TIRand", {
  36         var trig, outBus;
  37         trig = Dust.kr(10);
  38         outBus = TIRand.kr(0, 1, trig); //play on random channel between 0 and 1
  39         Out.ar(outBus, PinkNoise.ar(0.2))
  40
  41 }).play;
  42 )
  43
  44 (
  45 {
  46         var trig = Dust.kr(10);
  47         SinOsc.ar(
  48                         TIRand.kr(4, 12, trig) * 100
  49                 ) * 0.1
  50 }.play;
  51 )
  52
  53 (
  54 {
  55         var trig = Dust.ar(MouseX.kr(1, 8000, 1));
  56         SinOsc.ar(
  57                         TIRand.ar(4, 12, trig) * 100
  58                 ) * 0.1
  59 }.play;
  60 )
  61
  62 ::
  63