HelpSource/Classes/TExpRand.schelp

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