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


  ar    harmon   asig, kestfrq, kmaxvar, kgenfreq1, kgenfreq2, imode, iminfrq, iprd


Analyse an audio input and generate harmonizing voices in synchrony.


imode - interpeting mode for the generating frequency inputs kgenfreq1, kgenfreq2. 0: input values are ratios w.r.t. the audio signal analyzed cps. 1: input values are the actual requested frequencies in cps.

iminfrq - the lowest expected frequency (in cps) of the audio input. This parameter determines how much of the input is saved for the running analysis, and sets a lower bound on the internal pitch tracker.

iprd - period of analysis (in seconds). Since the internal pitch analysis can be time-consuming, the input is typically analysed only each 20 to 50 milliseconds.


This unit is a harmonizer, able to provide up to two additional voices with the same amplitude and spectrum as the input. The input analysis is assisted by two things: an input estimated frequency kestfrq (in cps), and a fractional maximum variance kmaxvar about that estimate which serves to limit the size of the search. Once the real input frequency is determined, the most recent pulse shape is used to generate the other voices at their requested frequencies.

The three frequency inputs can be derived in various ways from a score file or MIDI source. The first is the expected pitch, with a variance parameter allowing for inflections or inaccuracies; if the expected pitch is zero the harmonizer will be silent. The second and third pitches control the output frequencies; if either is zero the harmonizer will output only the non-zero request; if both are zero the harmonizer will be silent. When the requested frequency is higher than the input, the process requires additional computation due to overlapped output pulses. This is currently limited for efficiency reasons, with the result that only one voice can be higher than the input at any one time.

This unit is useful for supplying a background chorus effect on demand, or for correcting the pitch of a faulty input vocal. There is essentially no delay between input and output. Output includes only the generated parts, and does not include the input.


   asig1    in ; get the live input
   kcps1    cpsmidib ; and its target pitch
   asig2    harmon   asig1, kcps1, .3, kcps1, kcps1 * 1.25, 1, 110, .04 ; add maj 3rd
            out asig2 ; output just the corrected and added voices


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

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

HTML Csound Manual - © Jean Piché & Peter J. Nix, 1994-97