RMO

[GENERIC-FUNCTION]


OMTristan
Function Reference
ARGUMENTS:
  - s1 Chord [default = 6000]
  - s2 Chord [default = 6200]
&optional
 
  - type Type [default = (quote chord)]
  - unit Unit [default = (quote midic)]

Description:

Simulates the ring modulation of each note of <ch1> by all the notes of <ch2>. The frequency of each note of <ch2> is added to and subtracted from the frequency of each note of <ch1>; thus, all the possible additive and subtractive combinations are produced.

<ch1> and <ch2> may be midics, list of midics, list of lists of midics or chord objects.

The optional argument <unit> determines whether <ch1> and <ch2> are entered in midicents, ('midic'), or in hertz ('freq'). If 'midic' is
selected the values will be converted to frequencies inside the function and then the output is reconverted to midicents. If 'freq' is selected the entries, calculations and output are all in hertz. (note: Ring-modulation can produce negative frequencies; conversion to midicents will automatically reflect these notes back into the positive domain.)

When <ch1> contains multiple notes, the optional argument <type> is used to determine the format of the output. The value 'seq' returns a list of chords representing the modulation of each successive note of <ch1> by all the notes of <ch2>. The value 'chord' returns a single chord containing all the notes of all the modulations.

The output is always list of midics or list of list of midics. <ch1> and <ch2> may be chord objects in which case the unit is set to 'midic internally.

Certain combinations may produce too many levels of parentheses: In that case use <flat-once> after <ring-modulation>.



Auto doc generation by OpenMusic 7.0 © 2022 IRCAM