48 lines
791 B
Racket
48 lines
791 B
Racket
#lang scribble/manual
|
|
@(require (for-label racket))
|
|
|
|
@title{TChoose}
|
|
Randomly select one of several inputs@section{categories}
|
|
UGens>Triggers, UGens>Random
|
|
@section{related}
|
|
Classes/TWChoose
|
|
|
|
@section{description}
|
|
|
|
An output is selected randomly on receiving a trigger from an array of inputs.
|
|
|
|
TChoose returns a combination of link::Classes/Select:: and link::Classes/TIRand::.
|
|
|
|
@section{classmethods}
|
|
|
|
@section{method}
|
|
ar, kr
|
|
|
|
@section{argument}
|
|
trig
|
|
@section{argument}
|
|
array
|
|
|
|
@section{examples}
|
|
|
|
|
|
@racketblock[
|
|
(
|
|
{
|
|
var a;
|
|
a = [
|
|
SinOsc.ar,
|
|
Saw.ar,
|
|
Pulse.ar
|
|
];
|
|
TChoose.ar(Dust.ar(MouseX.kr(1, 1000, 1)), a) * 0.2
|
|
|
|
}.play;
|
|
)
|
|
::
|
|
|
|
]
|
|
@section{note}
|
|
all the ugens are continuously running. This may not be the most efficient way if each input is cpu-expensive.::
|
|
|
|
|