M-MAPPED-RHYTHM

[GENERIC-FUNCTION]


OMTimePack
Function Reference
ARGUMENTS:
  - pool list of generic durations and patterns (pattern = list of durations)  
  - ptable probability table (flat or nested list) controls random process  
  - vari-pulse variable pulse onto which generic durations will be mapped  
  - tot-time target duration of output rhythm [default = 0]
  - init-conds context for first few random choices  
&optional
 
  - offset start beyond beginning of vari-pulse [default = 0]
  - pattern-boundary-mode format of second output [default = (quote note)]

Description:


Randomly selects generic durations/patterns from POOL and maps them onto
the input VARI-PULSE to create a rhythm with a total duration of TOT-TIME.
Random selections are controlled by the probabilities in PTABLE. Mapping
starts from the beginning of VARI-PULSE, or with an optional OFFSET.

BPF-driven interpolation is possible on the PTABLE as in M-RHYTHM.

The first output is the resulting rhythm, the second delineates pattern
boundaries (as in M-RHYTHM), and the third reports the end context, which
may serve as initial conditions for the next in a cascaded series of
M-MAPPED-RHYTHM functions.



Auto doc generation by OpenMusic 6.3 © 2010 IRCAM