~ubuntu-branches/ubuntu/jaunty/tap-plugins/jaunty

« back to all changes in this revision

Viewing changes to doc/ladspa/reverb.html

  • Committer: Bazaar Package Importer
  • Author(s): Anand Kumria
  • Date: 2005-10-31 18:45:50 UTC
  • Revision ID: james.westby@ubuntu.com-20051031184550-80syq495jzgad34r
Tags: 0.7.0-2
* Include documentation (Closes: #303230)
* Revert change to biquad_run function (Closes: #315575)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
 
2
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 
4
 
 
5
<head>
 
6
<title>TAP-plugins</title>
 
7
<meta name="generator" content="GNU Emacs 21.2.1">
 
8
<meta http-equiv="Content-Type" content="text/html;
 
9
charset=iso-8859-1">
 
10
<meta name="description" content="Tom's Audio Processing plugins for
 
11
audio engineering on the Linux platform.">
 
12
<meta name="keywords" content="TAP-plugins TAP Reverb Editor
 
13
Reverberator Equalizer EQ Vibrato Tremolo Echo Tom Szilagyi LADSPA
 
14
JACK Plugin Linux Audio">
 
15
<meta name="author" content="Tom Szilagyi">
 
16
</head>
 
17
 
 
18
<body bgcolor=#ffffff>
 
19
<table cellpadding="5" cellspacing="0" border="0" bgcolor=#ffffc0
 
20
width="100%">
 
21
<tr><td>
 
22
<font size="+2" color=#004060><b>TAP</b>-plugins</font><br>
 
23
<font color=#004060>Tom's Audio Processing plugins</font><br>
 
24
<font size="-1" color=#004060><i>for audio engineering on the Linux
 
25
platform</i></font>
 
26
</td><td>
 
27
<center>
 
28
<a href="../index.html">[ Home ]</a>
 
29
<a href="../ladspa.html">[ LADSPA plugins ]</a>
 
30
<a href="../reverbed.html">[ TAP Reverb Editor ]</a>
 
31
</center>
 
32
<hr>
 
33
<center>
 
34
<a href="releases.html">[ Releases ]</a>
 
35
<a href="cvs.html">[ CVS ]</a>
 
36
<a href="general.html">[ General Info ]</a>
 
37
<a href="manuals.html">[ Plugin Manuals ]</a>
 
38
</center>
 
39
</td></tr>
 
40
</table>
 
41
 
 
42
<blockquote>
 
43
<a href="autopan.html">[&nbsp;TAP&nbsp;AutoPanner&nbsp;]</a>
 
44
<a href="chorusflanger.html">[&nbsp;TAP&nbsp;Chorus/Flanger&nbsp;]</a>
 
45
<a href="deesser.html">[&nbsp;TAP&nbsp;DeEsser&nbsp;]</a>
 
46
<a href="dynamics.html">[&nbsp;TAP&nbsp;Dynamics&nbsp;(Mono&nbsp;&&nbsp;Stereo)&nbsp;]</a>
 
47
<a href="eq.html">[&nbsp;TAP&nbsp;Equalizer&nbsp;and&nbsp;TAP&nbsp;Equalizer/BW&nbsp;]</a>
 
48
<a href="doubler.html">[&nbsp;TAP&nbsp;Fractal&nbsp;Doubler&nbsp;]</a>
 
49
<a href="pinknoise.html">[&nbsp;TAP&nbsp;Pink/Fractal&nbsp;Noise&nbsp;]</a>
 
50
<a href="pitch.html">[&nbsp;TAP&nbsp;Pitch&nbsp;Shifter&nbsp;]</a>
 
51
<a href="reflector.html">[&nbsp;TAP&nbsp;Reflector&nbsp;]</a>
 
52
<a href="reverb.html">[&nbsp;TAP&nbsp;Reverberator&nbsp;]</a>
 
53
<a href="rotspeak.html">[&nbsp;TAP&nbsp;Rotary&nbsp;Speaker&nbsp;]</a>
 
54
<a href="limiter.html">[&nbsp;TAP&nbsp;Scaling&nbsp;Limiter&nbsp;]</a>
 
55
<a href="sigmoid.html">[&nbsp;TAP&nbsp;Sigmoid&nbsp;Booster&nbsp;]</a>
 
56
<a href="echo.html">[&nbsp;TAP&nbsp;Stereo&nbsp;Echo&nbsp;]</a>
 
57
<a href="tremolo.html">[&nbsp;TAP&nbsp;Tremolo&nbsp;]</a>
 
58
<a href="tubewarmth.html">[&nbsp;TAP&nbsp;TubeWarmth&nbsp;]</a>
 
59
<a href="vibrato.html">[&nbsp;TAP&nbsp;Vibrato&nbsp;]</a>
 
60
</blockquote>
 
61
 
 
62
<h2>TAP Reverberator</h2>
 
63
<img src="tap_reverb.png" alt="[TAP Reverberator GUI as shown in Ardour]">
 
64
<p>
 
65
<b>TAP Reverberator</b> is unique among reverberators freely available
 
66
on the Linux platform. It supports creating no less than 43
 
67
reverberation effects, but its design permits this to be extended even
 
68
further by the user, without doing any actual programming. Please take
 
69
a look at <a href="../reverbed.html">TAP Reverb Editor</a>, a separate
 
70
JACK application for more information about this.
 
71
</p>
 
72
<p>
 
73
The design is based on the comb/allpass filter model. Comb filters
 
74
create early reflections and allpass filters add to this by creating a
 
75
dense reverberation effect. The output of the set of comb and allpass
 
76
filters (also called the reverberator chamber) is processed further by
 
77
sending it through a bandpass filter. The resulting band-limited
 
78
reverberation is very similar to the natural reverberation that occurs
 
79
in acoustic rooms. To achieve an even more natural-sounding effect,
 
80
all comb filters have high-frequency compensation in their feedback
 
81
loop. This is to model that the reflection ratio of acoustic surfaces
 
82
is the function of frequency: higher frequencies are attenuated more,
 
83
and thus decay time of higher frequency components is significantly
 
84
shorter.
 
85
</p>
 
86
<p>
 
87
To enhance the reverberation sound even further, a special option
 
88
called <i>Enhanced Stereo</i> is provided. When turned on (which is
 
89
the default), it results in an added spatial spread of the reverb
 
90
sound. This feature is most noticeable when applying the plugin to
 
91
mono tracks: the sound of these tracks will "open up" in space.
 
92
</p>
 
93
 
 
94
 
 
95
 
 
96
<h3>General information</h3>
 
97
 
 
98
<table cellspacing="0" cellpadding="5" border="1">
 
99
<tr><th align="left">Unique ID</th><td>2142</td>
 
100
<tr><th align="left">I/O ports</th><td>2 inputs / 2 outputs</td>
 
101
<tr><th align="left">CPU usage (44.1 kHz)</th><td>10.7% max. (see Notes)</td>
 
102
<tr><th align="left">CPU usage (96 kHz)</th><td>24.8% max. (see Notes)</td>
 
103
<tr><th align="left">Hard RT Capable</th><td>No</td></tr>
 
104
<tr><th align="left">In-place operation</th><td>Supported</td>
 
105
<tr><th align="left">run_adding() function</th><td>Provided</td>
 
106
</table>
 
107
 
 
108
 
 
109
<h3>Usage tips</h3>
 
110
<p>
 
111
Despite the rather complex algorithm of this plugin, usage is
 
112
relatively simple and the user is required to adjust only a limited
 
113
number of global controls. This is achieved by defining "presets"
 
114
called Reverb Types which actually mean larger sets of internal
 
115
control values. When choosing a Reverb Type, the plugin loads all
 
116
values associated to that type, and operates according to the newly
 
117
loaded values. (If you want access to the internals of a Reverb Type,
 
118
please check out <a href="../reverbed.html">TAP Reverb Editor</a>.)
 
119
</p>
 
120
<p>
 
121
The most important global variable of the whole effect is the decay
 
122
time.  By adjusting this, you can create the feel of a larger acoustic
 
123
space (set the decay to more than 2-3 seconds for this), as well as a
 
124
"tight", relatively dry effect (for which you should set a much lower
 
125
value).  But you should be aware of the fact that not every
 
126
reverberation type sounds good at any decay setting (see the table
 
127
below for recommended decay values). For example, a <i>Room
 
128
(Small)</i> will not sound too good when you set the decay to a very
 
129
large value, and vice versa, a <i>Hall (Large)</i> will not sound
 
130
optimal at very small decay settings. However, when choosing a more
 
131
artificial type of reverberation (<i>Afterburn</i>,
 
132
<i>Pulse Chamber (Reverse)</i> or <i>Warble Chamber</i>, for example),
 
133
there is no "natural" decay time: set it as you see fit according to
 
134
the effect you are trying to achieve.
 
135
</p>
 
136
<p>
 
137
General advice about adjusting the dry and wet signal levels: the wet
 
138
level should be about 3 to 15 dB lower than the dry level, according
 
139
to the reverb type you are using. Of course if you want to create an
 
140
artificial sounding effect, you can decrease the dry level, even down
 
141
to -70 dB if that is what you want. However, one thing to know is that
 
142
you shouldn't set the wet level to a very high value (generally not
 
143
above 0 dB) because the output level of the plugin may become too high
 
144
and you may overdrive the next plugin in the chain, or you may cause
 
145
signal clipping in the master output of your multitrack. Furthermore,
 
146
because the wet signal is added to the incoming dry signal, you should
 
147
decrease the dry level as well by a few dB-s (and then set the wet
 
148
level according to this) so as not to raise the overall loudness of
 
149
the track.
 
150
</p>
 
151
<p>
 
152
Usually, when trying to create a natural-sounding reverberation
 
153
effect, all components (comb filters, allpass filters, the bandpass
 
154
filter and the stereo enhancement mode) should be switched
 
155
on. However, to create artificial effects, it is possible to turn off
 
156
any of these components. For example, if you only want the sound of
 
157
multiple echoes, you can turn off everything but the comb filters; if
 
158
you want to create a more unnatural, harsh effect, turn off the
 
159
bandpass filter processing. (Also note that bandpass filters of
 
160
different Reverb Types have different low and high cutoff frequencies,
 
161
since this filtering also affects the nature of the reverberated sound
 
162
very much.) Naturally, components that are switched off don't consume
 
163
CPU power.
 
164
</p>
 
165
<p>
 
166
As mentioned earlier, not all Reverb Types sound good with any decay
 
167
setting. The following table contains decay time settings adequate for
 
168
particular Reverb Types. Decay times are shown in seconds. As a rule of
 
169
thumb, when decay times are above 3 seconds, the "Wet Level" should be
 
170
at least 6 or more decibels below the "Dry Level". <i>The values
 
171
below are only general advice, and they are provided merely as a
 
172
starting point for your experimentation. You are free to use any value
 
173
that sounds good for your mix.</i>
 
174
</p>
 
175
 
 
176
<h3>Recommended decay times</h3>
 
177
<table cellspacing="0" cellpadding="5" border="1">
 
178
<tr><th>Reverb Type</th><th>Decay Time</th></tr>
 
179
<tr><td>AfterBurn</td><td>2.8</td></tr>
 
180
<tr><td>AfterBurn (Long)</td><td>4.8</td></tr>
 
181
<tr><td>Ambience</td><td>1.1</td></tr>
 
182
<tr><td>Ambience (Thick)</td><td>1.2</td></tr>
 
183
<tr><td>Ambience (Thick) - HD</td><td>1.2</td></tr>
 
184
<tr><td>Cathedral</td><td>10</td></tr>
 
185
<tr><td>Cathedral - HD</td><td>10</td></tr>
 
186
<tr><td>Drum Chamber</td><td>3.6</td></tr>
 
187
<tr><td>Garage</td><td>2.3</td></tr>
 
188
<tr><td>Garage (Bright)</td><td>2.3</td></tr>
 
189
<tr><td>Gymnasium</td><td>5.9</td></tr>
 
190
<tr><td>Gymnasium (Bright)</td><td>5.9</td></tr>
 
191
<tr><td>Gymnasium (Bright) - HD</td><td>5.9</td></tr>
 
192
<tr><td>Hall (Small)</td><td>2.0</td></tr>
 
193
<tr><td>Hall (Medium)</td><td>3.0</td></tr>
 
194
<tr><td>Hall (Large)</td><td>5.1</td></tr>
 
195
<tr><td>Hall (Large) - HD</td><td>5.1</td></tr>
 
196
<tr><td>Plate (Small)</td><td>1.7</td></tr>
 
197
<tr><td>Plate (Medium)</td><td>2.6</td></tr>
 
198
<tr><td>Plate (Large)</td><td>5.7</td></tr>
 
199
<tr><td>Plate (Large) - HD</td><td>5.7</td></tr>
 
200
<tr><td>Pulse Chamber</td><td>3.1</td></tr>
 
201
<tr><td>Pulse Chamber (Reverse)</td><td>3.1</td></tr>
 
202
<tr><td>Resonator (96 ms)</td><td>4.0</td></tr>
 
203
<tr><td>Resonator (152 ms)</td><td>4.2</td></tr>
 
204
<tr><td>Resonator (208 ms)</td><td>5.1</td></tr>
 
205
<tr><td>Room (Small)</td><td>1.9</td></tr>
 
206
<tr><td>Room (Medium)</td><td>2.8</td></tr>
 
207
<tr><td>Room (Large)</td><td>4.4</td></tr>
 
208
<tr><td>Room (Large) - HD</td><td>4.4</td></tr>
 
209
<tr><td>Slap Chamber</td><td>2.3</td></tr>
 
210
<tr><td>Slap Chamber - HD</td><td>2.9</td></tr>
 
211
<tr><td>Slap Chamber (Bright)</td><td>3.4</td></tr>
 
212
<tr><td>Slap Chamber (Bright) - HD</td><td>3.7</td></tr>
 
213
<tr><td>Smooth Hall (Small)</td><td>1.8</td></tr>
 
214
<tr><td>Smooth Hall (Medium)</td><td>3.0</td></tr>
 
215
<tr><td>Smooth Hall (Large)</td><td>5.9</td></tr>
 
216
<tr><td>Smooth Hall (Large) - HD</td><td>5.9</td></tr>
 
217
<tr><td>Vocal Plate</td><td>3.1</td></tr>
 
218
<tr><td>Vocal Plate - HD</td><td>3.1</td></tr>
 
219
<tr><td>Warble Chamber</td><td>4.0</td></tr>
 
220
<tr><td>Warehouse</td><td>6.0</td></tr>
 
221
<tr><td>Warehouse - HD</td><td>6.0</td></tr>
 
222
</table>
 
223
 
 
224
 
 
225
<br>
 
226
<p>
 
227
<b>Q:</b> <i>What is that HD in the name of some Reverb Types?</i>
 
228
</p>
 
229
<p>
 
230
<b>A:</b> HD stands for <i>High Density</i>. Reverb Types marked with
 
231
this are enhanced versions of other types, for example <i>Hall (Large)
 
232
- HD</i> is derived from <i>Hall (Large)</i>. Enhancement means
 
233
additional comb and/or allpass filters, which result in an even
 
234
smoother reverberation effect. However, more filters mean more CPU
 
235
usage, so it's up to you to decide whether to choose them or not. If
 
236
CPU usage is not a great concern, it is recommended to use the HD
 
237
versions where available.
 
238
</p>
 
239
 
 
240
 
 
241
<h3>Summary of user controls</h3>
 
242
 
 
243
<table cellspacing="0" cellpadding="5" border="1">
 
244
<tr><th>name</th><th>min. value</th><th>default value</th><th>max. value</th></tr>
 
245
 
 
246
<tr align="center"><td>Decay [ms]</td>
 
247
<td>0</td>
 
248
<td>2500</td>
 
249
<td>10000</td></tr>
 
250
<tr align="center"><td>Dry Level [dB]</td>
 
251
<td>-70</td>
 
252
<td>0</td>
 
253
<td>+10</td></tr>
 
254
<tr align="center"><td>Wet Level [dB]</td>
 
255
<td>-70</td>
 
256
<td>0</td>
 
257
<td>+10</td></tr>
 
258
<tr align="center"><td>Comb Filters</td>
 
259
<td>OFF</td>
 
260
<td>ON</td>
 
261
<td>ON</td></tr>
 
262
<tr align="center"><td>Allpass Filters</td>
 
263
<td>OFF</td>
 
264
<td>ON</td>
 
265
<td>ON</td></tr>
 
266
<tr align="center"><td>Bandpass Filter</td>
 
267
<td>OFF</td>
 
268
<td>ON</td>
 
269
<td>ON</td></tr>
 
270
<tr align="center"><td>Enhanced Stereo</td>
 
271
<td>OFF</td>
 
272
<td>ON</td>
 
273
<td>ON</td></tr>
 
274
<tr align="center"><td>Reverb Type</td>
 
275
<td>0</td>
 
276
<td>0</td>
 
277
<td>42</td></tr>
 
278
 
 
279
</table>
 
280
 
 
281
 
 
282
<h3>Notes</h3>
 
283
<p>
 
284
The maximum number of filters is 20 combs and 20 allpass
 
285
filters. Actually it is double this much because every filter exists
 
286
in two instances for the two channels.  This amount allows for the
 
287
creation of very dense, very smooth-sounding Reverb Types.
 
288
</p>
 
289
<p>
 
290
Comb filters are implemented as first-order IIR filters with a
 
291
biquadratic low-pass filter in the feedback loop, which has its cutoff
 
292
frequency determined by the frequency response parameter of the comb
 
293
filter. Allpass filters are implemented as ordinary first-order IIR
 
294
filters.
 
295
</p>
 
296
<p>
 
297
When <i>Enhanced Stereo</i> is enabled, parameters of the two
 
298
instances of the same filter are set to slightly different values.
 
299
Without this option, the two input channels are processed in the exact
 
300
same way. It is absolutely recommended to turn this on when applying
 
301
the plugin to mono tracks, but it is also useful on stereo tracks.
 
302
</p>
 
303
<p>
 
304
Because the varying complexity of Reverb Types and the fact that
 
305
options can be switched on/off individually, CPU usage is a function
 
306
of user settings. For this reason, this plugin is not hard RT
 
307
capable. The CPU usage was measured with all options turned on, and
 
308
the Reverb Type set to <i>Ambience (Thick) - HD</i>, which is the most
 
309
complex one at the moment. Other Reverb Types with fewer
 
310
comb/allpass filters utilize proportionately less CPU.
 
311
</p>
 
312
 
 
313
 
 
314
<br><hr>
 
315
<center>
 
316
$Id: reverb.html,v 1.3 2004/08/17 13:05:16 tszilagyi Exp $
 
317
</center>
 
318
</body></html>