Forgot a help fix: Drag a dock's title bar, not divider, to reposition
[supercollider.git] / HelpSource / Classes / Formant.schelp
blob47add42eeb8f0a1c3f6a7cef40daddfe6d60f36e
1 class:: Formant
2 summary:: Formant oscillator
3 categories::  UGens>Generators>Deterministic
6 Description::
8 Generates a set of harmonics around a formant frequency at a given
9 fundamental frequency.
12 classmethods::
14 method::ar
16 argument::fundfreq
17 Fundamental frequency in Hertz. (control rate)
19 argument::formfreq
20 Formant frequency in Hertz. (control rate)
22 argument::bwfreq
23 Pulse width frequency in Hertz. Controls the bandwidth of the
24 formant. (control rate)
26 Must be greater than or equal to code::fundfreq::.
28 argument::mul
30 argument::add
32 discussion::
33 The frequency inputs are read at control rate only, so if you use an audio rate UGen as an input, it will only be sampled at the start of each audio synthesis block.
36 Examples::
38 code::
39 // modulate fundamental frequency, formant freq stays constant
40 { Formant.ar(XLine.kr(400,1000, 8), 2000, 800, 0.125) }.play
42 // modulate formant frequency, fundamental freq stays constant
43 { Formant.ar(200, XLine.kr(400, 4000, 8), 200, 0.125) }.play
45 // modulate width frequency, other freqs stay constant
46 { Formant.ar(400, 2000, XLine.kr(800, 8000, 8), 0.125) }.play