A UGen providing a probability-weighted index into a sequence upon receiving a trigger.
When triggered, returns a random index value based the values of the channels
of the prob argument functioning as probabilities. The index is zero based,
hence goes from 0 to prob.numOutputs - 1 .
By default the sequence of probabilities should sum to 1.0, however for
convenience, this can be achieved by the ugen when the normalize flag is set
to 1 (less efficient).
- Value Params
- normalize
0if the seq argument already sums up to 1.0 and thus doesn't need normalization,1if the sum is not guaranteed to be 1.0 and thus the ugen is asked to provide the normalization.- prob
a multi-channel graph element, where the output channels correspond to to the probabilities of their respective indices being chosen.
- trig
the trigger used to calculate a new index. a trigger occurs when passing from non-positive to positive
- See also
- Companion
- object