Debian Codegraph @

effects/chorus/README

raw
1 -----------------------------------------------------------------------------------
2
3 Copyright (C) 2003-2008 Fons Adriaensen <[email protected]>
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18
19 -----------------------------------------------------------------------------------
20
21
22 --------------------------------------------
23 cs_phaser.so -- version 0.4.0 - 5/4/2008
24 --------------------------------------------
25
26 Code cleanup.
27
28 --------------------------------------------
29 cs_phaser.so -- version 0.3.0 - 10/4/2004
30 --------------------------------------------
31
32 Assured central frequency is middle C for zero control voltage
33
34 --------------------------------------------
35 cs_phaser.so -- First release - 20/5/2003
36 --------------------------------------------
37
38 This is similar to the CSound module 'phaser1'. It's a series
39 connection of 1 to 30 first order allpass filters with feedback.
40 For 'Output mix', the range -1 to 0 crossfades between the inverted
41 output and the input, and the range 0 to 1 crossfades between the
42 input and the non-inverted output. Without feedback, the maximum
43 effect is at +/- 0.5. For both 'Feedback gain' and 'Output mix',
44 the best polarity depends on whether the number of sections is
45 even or odd.
46
47 Phaser1+LFO is the same thing, but the external modulation has
48 been replaced by a built-in LFO. The 'LFO waveform' control ranges
49 from a falling saw wave (-1), over triangle (0), to a rising saw
50 wave (+1).
51
52 Note: CSound's 'phaser2' is in the pipeline.
53
54
55 --------------------------------------------
56 cs_chorus.so -- version 0.4.0 - 5/4/2008
57 --------------------------------------------
58
59 Code cleanup and triple output version added.
60 The third one is as the second, but has three
61 separate outputs. Pan L,C,R for a nice stereo
62 effect.
63
64 --------------------------------------------
65 cs_chorus.so -- version 0.3.0 - 10/4/2004
66 --------------------------------------------
67 --------------------------------------------
68 cs_chorus.so -- First release - 20/5/2003
69 --------------------------------------------
70
71 These two plugins are based on a CSound orchestra file by Sean Costello.
72 There are two low frequency oscillators, each having three outputs
73 that are 120 degrees apart in phase. The summed outputs modulate three
74 delay lines. Make sure the static delay (first parameter) is at least
75 equal to the sum of the two modulation depths.
76 The two plugins are functionally identical. The second one upsamples
77 the input to the delay lines in an attempt to mitigate the errors
78 produced by the linear interpolation at the output. If you hear any
79 difference please let me know which one you prefer.
80
81
82
83 --------------------------------------------
84 mvclpf24.so -- version 0.4.0 - 5/4/2008
85 --------------------------------------------
86
87 Code cleanup.
88
89 --------------------------------------------
90 mvclpf24.so -- version 0.3.0 - 10/4/2004
91 --------------------------------------------
92
93 Assured central frequency is middle C for zero control voltage
94
95 --------------------------------------------
96 mvclpf24.so -- version 0.1.3 - 22/8/2003
97 --------------------------------------------
98
99 Renamed parameter "Output" in Mvclpf-4 to "Filter poles".
100
101 --------------------------------------------
102 mvclpf24.so -- version 0.1.2 - 28/7/2003
103 --------------------------------------------
104
105 Added fourth version, offering 0, 6, 12, 18, 24 dB/oct outputs.
106
107 Changed filenames, plugin names and labels to avoid any possible
108 trademark related problems. I'm happy Bob Moog is back in business,
109 and surely do not want any trouble with him.
110
111 Added a quick hack solution to stop FP denormalization. This will
112 be improved on in future versions.
113
114 --------------------------------------------
115 mvclpf24.so -- First release - 25/4/2003
116 --------------------------------------------
117
118 Description
119 -----------
120
121 The mvclpf24 plugin contains four versions of a digital implementation of
122 the voltage controlled lowpass filter as used in vintage Moog synthesizers.
123 Many software versions of this filter already exist. Most use some limiting
124 mechanism in order to keep the self-oscillation amplitude under control, but
125 as far as I know, none of them attempt to accurately emulate the non-linear
126 circuit elements of the original analog filter. To do this has been the
127 main reason for developing this plugin.
128
129
130 The Moog VCF
131 ------------
132
133 The basic architecture of the Moog VCF is quite simple: it consists of a
134 chain of four first order RC filters and a feedback path. In the clever
135 design by Robert Moog, the four filter sections are current driven
136 parallel RC combinations, the current flowing in the resistor of one
137 section also being the input signal for the next. The 'resistors' are
138 each formed by the series connection (as far as the signal is concerned)
139 of two forward-biased base-emitter junctions, the impedance of which is
140 controlled by the bias current coming from an exponentially controlled
141 current source.
142 Whereas for a normal resistor we would have I_R / V_R = constant = 1/R,
143 in this scheme we find I_R = w * tanh(V_R), where w is proportional to
144 the bias current. Thus the impedance increases with signal level, which
145 explains why the resonance frequency rises (by about one semitone) when
146 the filter is taken out of self-oscillation by decreasing the feedback.
147
148
149 The four versions
150 ------------------
151
152 Mvclpf-1 is a fairly simple design, and it does not even pretend to come
153 close the 'real thing'. It uses a very crude approximation of the non-linear
154 resistor in the first filter section only. I retained it in this distribution
155 because it's a cheap (in terms of CPU usage) general purpose 24 dB/oct lowpass
156 filter that could be useful, and for sentimental reasons since this was my
157 first ever LADSPA plugin.
158
159 Mvclpf-2 uses five non-linear elements, in the input and in all four filter
160 sections. It works by using the derivative of the nonlinearity (for which
161 1 / (1 + x * x) is reasonable approximation). The main advantage of this is
162 that only one evaluation of the non-linear function is required for each
163 section. The four variables that contain the filter state (c1...c4) represent
164 not the voltage on the capacitors (as in the first filter) but the current
165 flowing in the resistive part.
166
167 Mvclpf-3 is based on the previous one, with two differences. It uses the
168 the technique described by Stilson and Smith to extend the constant-Q
169 range, and the internal sample frequency is doubled, giving a better
170 approximation to the non-linear behaviour at high freqencies.
171 This version has high Q over the entire frequency range and will
172 oscillate up to above 10 kHz, while the two others show a decreasing
173 Q at high frequencies. Moogvcf3 is reasonably well tuned, and can be
174 'played' as a VCO up to at least 5 kHz.
175
176 Mvclpf-4 is the same as the previous one, but adds a selection of 0, 6, 12,
177 18 or 24 db/oct output.
178
179 All four versions subsample the audio rate controls to 1/16, with linear
180 interpolation in between. This could be changed at the expense of more
181 CPU cycles.
182
183
184 --------------------------------------------
185 mvclpf24.so -- version 0.4.0 - 5/4/2008
186 --------------------------------------------
187
188 Code cleanup.
189
190 --------------------------------------------
191 mvchpf24.so -- First release - 10/4/2004
192 --------------------------------------------
193
194 This is based on the voltage controlled highpass filter by Robert Moog.
195 again with some attention to the nonlinear effects. This are quite
196 different from the lowpass filters. When you 'overdrive' the filter,
197 the cutoff frequency will rise.
198
199 This first version is really very experimental.
200
201
202 -------
203 Thanks
204 -------
205
206 Many thanks are due to Dr. Matthias Nagorni of SuSE AG, who first prodded
207 me gently to undertake the development of the lowpass plugin, later of the
208 cs_phaser and cs_chorus, and who provided invaluable feedback and comments on
209 the early versions. The higpass filter was also developed following a request
210 from Matthias, and he has already made some spectacular AMS patches with it.
211