rsc3/doc-schelp/HelpSource/Classes/TIRand.scrbl

82 lines
1.2 KiB
Racket

#lang scribble/manual
@(require (for-label racket))
@title{TIRand}
Triggered integer random number generator.@section{related}
Classes/ExpRand, Classes/IRand, Classes/LinRand, Classes/NRand, Classes/Rand, Classes/TExpRand, Classes/TRand, Classes/TChoose
@section{categories}
UGens>Random, UGens>Triggers
@section{description}
Generates a random integer value in uniform distribution from
@racketblock[lo:: to ]
@racketblock[hi:: each time the
trigger signal changes from nonpositive to positive values.
]
@section{classmethods}
@section{method}
ar, kr
@section{argument}
lo
Lower limit of the output range.
@section{argument}
hi
Upper limit of the output range.
@section{argument}
trig
The trigger. Trigger can be any signal. A trigger happens when
the signal changes from non-positive to positive.
@section{Examples}
@racketblock[
(
SynthDef("help-TIRand", {
var trig, outBus;
trig = Dust.kr(10);
outBus = TIRand.kr(0, 1, trig); //play on random channel between 0 and 1
Out.ar(outBus, PinkNoise.ar(0.2))
}).play;
)
(
{
var trig = Dust.kr(10);
SinOsc.ar(
TIRand.kr(4, 12, trig) * 100
) * 0.1
}.play;
)
(
{
var trig = Dust.ar(MouseX.kr(1, 8000, 1));
SinOsc.ar(
TIRand.ar(4, 12, trig) * 100
) * 0.1
}.play;
)
::
]