HelpSource/Classes/LinRand.schelp

   1 class:: LinRand
   2 summary:: Skewed random number generator.
   3 related:: Classes/ExpRand, Classes/IRand, Classes/NRand, Classes/Rand, Classes/TExpRand, Classes/TIRand, Classes/TRand
   4 categories:: UGens>Random
   5
   6 Description::
   7
   8 Generates a single random float value in linear distribution from
   9 code::lo::  to  code::hi:: , skewed towards
  10 code::lo::  if  code::minmax::  < 0, otherwise
  11 skewed towards  code::hi:: .
  12
  13
  14 classmethods::
  15
  16 method::new
  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::minmax
  25 The output is skewed towards code::lo:: if code::minmax:: < 0, otherwise skewed towards code::hi::.
  26
  27 Examples::
  28
  29 code::
  30
  31 (
  32 SynthDef("help-LinRand", { arg out=0, minmax=1;
  33         Out.ar(out,
  34                 FSinOsc.ar(
  35                         LinRand(200.0, 10000.0, minmax),
  36                         0, Line.kr(0.2, 0, 0.01, doneAction:2))
  37         )
  38 }).send(s);
  39 )
  40
  41 //towards hi
  42 (
  43 Routine({
  44         loop({
  45                 Synth.new("help-LinRand"); 0.04.wait;
  46         })
  47 }).play;
  48 )
  49
  50 //towards lo (doesn't work like that yet)
  51 (
  52 Routine({
  53         loop({
  54                 Synth.new("help-LinRand", [\minmax, -1]); 0.04.wait;
  55         })
  56 }).play;
  57 )
  58
  59 ::
  60