RND

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next

irnd, krnd, ibirnd, ibirnd, ftlen, ftlptim

     irnd(x)        
     krnd(x)
     ibirnd(x)     
     kbirnd(x)
     ftlen(x)      (init-rate args only)
     ftlptim(x)    (init-rate args only)

DESCRIPTION

where the argument within the parentheses may be an expression. These value converters sample a global random sequence or return information about a stored function table. The result can be a term in a further expression.

PERFORMANCE

rnd(x)

returns a random number in the unipolar range 0 to x. The form irnd(x) returns at i-rate.

The form krnd(x) returns at k-rate

birnd(x)

returns a random number in the bipolar range -x to x.

These units obtain values from a global pseudo-random number generator,

then scale them into the requested range. The single global generator will

thus distribute its sequence to these units throughout the performance,

in whatever order the requests arrive. The form ibirnd(x) returns at i-rate.

The form kbirnd(x) returns at k-rate

ftlen(x)

returns the size (no. of points, excl. guard point) of stored function table no. x.

While most units referencing a stored table will automatically take its size

into account (so tables can be of arbitrary length), this function reports

the actual size if that is needed.

ftlptim(x)

returns the loop segment start-time (in seconds) of stored function table no. x.

This reports the duration of the direct recorded attack and decay parts of a

sound sample, prior to its looped segment. Returns zero (and a warning message)

if the sample does not contain loop points.

AUTHOR:

Barry Vercoe
M.I.T., Cambridge, Mass
1997

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next