Merge remote-tracking branch 'github/master'
[zynaddsubfx-code.git] / doc / lfo.txt
blob9d86d552a1786a03c886f7a587b5735147f16875
1 LFO
2 ---
3 :author: Paul Nasca
5 Introduction
6 ~~~~~~~~~~~~
8 "LFO" means Low Frequency Oscillator.
9 These oscillators are not used to make sounds by themselves, but they changes
10 some parameters (like the frequencies, the amplitudes or the filters).
12 The LFOs have some basic parameters:
14 * *Delay*: This parameter sets how much time takes since the start of the
15            note to the start of the LFO
16 * *Start Phase*: The position that a LFO will start at
17 * *Frequency*: How fast the LFO is (i.e. how fast the parameter's controlled by
18                the LFO changes)
19 * *Depth*: The amplitude of the LFO (i.e. how much the parameter's controlled
20            by the LFO changes)
22 image:images/lfo0.png[]
24 Another important LFO parameter is the shape.
25 There are many LFO Types according to the shape.
26 ZynAddSubFX supports the following LFO shapes:
28 image:images/lfo1.png[]
30 Another parameter is the LFO Randomness.
31 It modifies the LFO amplitude or the LFO frequency at random.
32 In ZynAddSubFX you can choose how much the LFO frequency or LFO amplitude
33 changes by this parameter.
34 In the following images are shown some examples of randomness and how changes
35 the shape of a triangle LFO.
37 image:images/lfo2.png[]
39 Other parameters are:
41 * *Continuous mode*: If this mode is used, the LFO will not start from "zero" on each new note, but it will be continuous. This is very useful if you apply on filters to make interesting sweeps.
42 * *Stretch*: It controls how much the LFO frequency changes according to the
43 note's frequency.
44 It can vary from negative stretch (the LFO frequency is decreased on higher
45 notes) to zero (the LFO frequency will be the same on all notes) to positive
46 stretch (the LFO frequency will be increased on higher notes).
48 User Interface
49 ~~~~~~~~~~~~~~
51 In ZynAddSubFX, LFO parameters are shown as:
53 image:images/uilfo.jpg[]
55 These parameters are:
57 * *Freq*: LFO Frequency
58 * *Depth*: LFO Depth
59 * *Start*: LFO Start Phase - 
60 If this knob is at the lowest value, the LFO Start Phase will be random.
61 * *Delay*: LFO Delay
62 * *A.R.*: LFO Amplitude Randomness
63 * *F.R.*: LFO Frequency Randomness
64 * *C.*: LFO Continuous Mode
65 * *Str.*: LFO Stretch - in the image above the LFO stretch is set to zero