File: caps.html

package info (click to toggle)
caps 0.3.0-3
links: PTS
area: main
in suites: etch, etch-m68k
size: 888 kB
ctags: 1,273
sloc: cpp: 9,837; ansic: 584; makefile: 62
file content (1580 lines) | stat: -rw-r--r-- 50,205 bytes
<html>
	<head>
		<title>The CAPS Audio Plugin Suite</title>
		<style type=text/css>
			body, table {
				font-family: Helvetica, Tahoma, Geneva, sans-serif;
			}
			
			h1, h2 {
				padding-top: 2pt;
				padding-bottom: 2pt;
				border-bottom: solid 1px black;
				sborder-top: solid 1px black;
				sbackground-color: #eeeeee;
				stext-align: center;
			}

			h3 {
				width: 70%;
				border-bottom: solid 1px #cccccc;
				margin-top: 24pt;
			}

			h4 {
				width: 70%;
				border-bottom: dotted 1px #dddddd;
			}

			a	{
				font-weight: normal;
				text-decoration: none;
			}
			
			a:hover {
				text-decoration: underline;
			}

			a:visited {
				color: #7f7f00;
			}
			
			a:link {
				color: #1d30e7;
			}

			a.quitte,a.quitte:visited {
				text-decoration: none;
			}

			a.foot {
				color: #7588ff;
			}

			td.sm {
				font-size: 90%;
			}

			td.q {
				padding-left: 20px;
				padding-right: 20px;
				padding-top: 16px;
				padding-bottom: 16px;
			}

			td.q a, td.q a:visited {
				text-decoration: none;
				color: #ffffff;
			}

			td.q a.quitte {
				font-size: 16pt;
			}

			#gray {background-color: #dddddd;}
			#c0 {background-color: #5da0d7;}
			#c1 {background-color: #efaa59;}
			#c2 {background-color: #efcb30;}
			#c3 {background-color: #84a68c;}
			#c4 {background-color: #a80d1b;}
			#c5 {background-color: #7a6fa0;} // originally night magenta

			sup {
				font-size: 30%;
			}

			div.foot {
				padding-top: 2pt;
				padding-bottom: 2pt;
				border-top: solid 1px black;
				border-bottom: solid 1px black;
				background-color: #eeeeee;
			}

			p.attrib {
				font-size: 90%;
				text-align: right;
			}

			#foot {
				font-size: 90%;
			}

			#bg {
				//padding-top: 1pt;
				//padding-bottom: 1pt;
				font-size: 120%;
			}
			
			#warn {
				color: #ff0000;
			}

			
		h3 {margin-top: 18em;} 
		h4 {font-size: 11pt; padding-top: 2em;} 
		h5 {font-size: medium; margin-bottom: .5em;} 
		p {max-width: 42em;} 
		body {margin: 18px;} 
		p#foot {border-top: solid 1px black;}
		h3 {font-size: 14pt; border-bottom: solid 1px black;}
		h4 {color: #aa0000; border-bottom: solid 1px black;}
		h4 {margin-top: 21px;margin-bottom: 0px;}
		ul {max-width: 36em; margin-bottom: 1em;} 
		ul#plugs {margin-top: 1em; font-size:80%;} 
		li.bg {font-size: large;}
		li {margin-bottom: .4em;}
		table {padding-bottom:1em; border-bottom: solid 1px black;margin-bottom: 12px;}		</style>
	</head>

	<body>
		<center>
		<div align=left>

			<h2>The CAPS Audio Plugin Suite</h2>	<table border=0 width=100% cellpadding=0 cellspacing=0>
		<tr>
			<td align=left width=20%>
				<b>Release 0.3.0</b>
			</td>
			<td rowspan=2 align=center>
				<a href=http://quitte.de/dsp/caps.html title="Yes, this page, only guaranteed fresh!">http://quitte.de/dsp/caps.html</a>
			</td>
			<td align=right width=20%>
				<b>Tim Goetze</b>
			</td>
		</tr>
		<tr>
			<td align=left>
				January 11, 2006			</td>
			<td align=right>
				<a href=mailto:tim@quitte.de?subject=caps>tim@quitte.de</a>
			</td>
		</tr>
		<tr>
		</tr>
	</table>
	
	<ul>
		<li class=bg><a href=#FrontMatter>Front Matter</a></li>
		<li class=bg><a href=#Download>Download</a></li>
		<li class=bg><a href=#Installation>Installation</a></li>
		<li class=bg><a href=#WhatYouShouldKnow>What You Should Know</a></li>
		<li class=bg><a href=#ThePlugins>The Plugins</a>
			
		<ul id=plugs type=square>
			<li><a href=#Generic>Generic</a></li><ul type=circle>
				<li><a href=#Eq>Eq</a></li>
				<li><a href=#Compress>Compress</a></li>
				<li><a href=#Pan>Pan</a></li>
			</ul>
			<li><a href=#Emulation>Emulation</a></li><ul type=circle>
				<li><a href=#PreampIII>PreampIII</a></li>
				<li><a href=#PreampIV>PreampIV</a></li>
				<li><a href=#AmpIII>AmpIII</a></li>
				<li><a href=#AmpIV>AmpIV</a></li>
				<li><a href=#AmpV>AmpV</a></li>
				<li><a href=#CabinetI>CabinetI</a></li>
				<li><a href=#CabinetII>CabinetII</a></li>
				<li><a href=#Clip>Clip</a></li>
			</ul>
			<li><a href=#Effects>Effects</a></li><ul type=circle>
				<li><a href=#ChorusI>ChorusI</a></li>
				<li><a href=#StereoChorusI>StereoChorusI</a></li>
				<li><a href=#ChorusII>ChorusII</a></li>
				<li><a href=#StereoChorusII>StereoChorusII</a></li>
				<li><a href=#PhaserI>PhaserI</a></li>
				<li><a href=#PhaserII>PhaserII</a></li>
				<li><a href=#SweepVFI>SweepVFI</a></li>
				<li><a href=#SweepVFII>SweepVFII</a></li>
				<li><a href=#Scape>Scape</a></li>
			</ul>
			<li><a href=#Generators>Generators</a></li><ul type=circle>
				<li><a href=#VCOs>VCOs</a></li>
				<li><a href=#VCOd>VCOd</a></li>
				<li><a href=#CEO>CEO</a></li>
				<li><a href=#Sin>Sin</a></li>
				<li><a href=#White>White</a></li>
				<li><a href=#Lorenz>Lorenz</a></li>
				<li><a href=#Roessler>Roessler</a></li>
			</ul>
			<li><a href=#Reverb>Reverb</a></li><ul type=circle>
				<li><a href=#JVRev>JVRev</a></li>
				<li><a href=#Plate>Plate</a></li>
				<li><a href=#Plate2x2>Plate2x2</a></li>
			</ul>
			<li><a href=#Others>Others</a></li><ul type=circle>
				<li><a href=#Click>Click</a></li>
				<li><a href=#Dirac>Dirac</a></li>
				<li><a href=#HRTF>HRTF</a></li>
			</ul>
		</ul></li>
		<li class=bg><a href=#Appendix>Appendix</a></li>
		<ul type=square>
			<li><a href=#DataSheet>Plugin Data Sheets</a></li>
			<li><a href=#Changelog>Changelog</a></li>
		</ul>
	</ul>
	
	&nbsp;<br>

	<a name=FrontMatter><h3>Front Matter</h3></a>
	<p>
		<b>caps</b>, the C* Audio Plugin Suite, is a collection of
		highly refined
		<a href=http://www.ladspa.org>LADSPA</a> units capable of (and 
		intended for) realtime operation. The suite includes DSP units emulating 
		instrument amplifiers, stomp-box classics, 
		versatile 'virtual analogue' oscillators,
		fractal oscillation, reverb, equalization and others.
	</p>
	<p>
		My favourite user's quote: 
		<i>&ldquo;... if your amps beat your plugins, they
		are *very good* amps.. ;-)&rdquo;</i> &ndash; Thanks, Pete!
	</p>
	<p>
		Most of the suite is of my own invention, 
		while some plugins are rewrites of 
		existing designs, included because of  
		their excellence or interest. Inspiring code was authored by
		(in no particular order): 
		Andrew Simper, Perry Cook, Gary Scavone, Steve
		Harris, Richard Dobson, Bram de Jong and others.
	</p>
	<p>
		All of caps is <a href=COPYING>free software</a> and distributed
		in source code. 
	</p>
	&nbsp;<br>

	<h5>* What's with the C?</h5>
	<p>
		So what does the <i>C</i> in the name stand for? Honestly, I don't know.
	</p>
	<p>
		<i>Complete?</i> Not yet. <br>
		<i>C</i> as in the programming language? The source is C++.<br>
		<i>Crap?</i> Heaven forbid!<br>
		<i>Cute?</i> Why not ...<br>
		<i>Common?</i> Not bad either. <br>
		<i>C,</i> the latin numeral for one-hundred? Some more to go, but I
		like the idea.
	</p>
	<p>
		I've got it! <i>C</i> as in <i>The <u>C</u>aps Audio Plugin Suite!</i> 
		A classic.
	</p>
	<p>
		I'll be glad to hear your suggestions.
	</p>

	&nbsp;<br>

	<a name=Download><h3>Download</h3></a>
	<p>
		caps is distributed under the 
		<a href=COPYING>GNU General Public License</a>. Other licensing terms
		can be arranged if you wish, please feel free to contact me.
	</p>

	<h5>No Guarantee</h5>
	<p>
		While I have bred all the plugins in the suite with the greatest care, 
		there is no guarantee
		that they will all retain perfect manners under all possible 
		circumstances. Take, for example, the <a href=#Lorenz>Lorenz</a>
		plugin, which models
		a fractal system. How am I to guarantee its 
		output will never go out of range, if people far more knowledgeable
		about this fractal than me assert its unpredictable behaviour?
	</p>

	<p style="border:dotted 1px #777777;padding:3pt;">
		This collection is distributed in the hope that it will be useful,
		but WITHOUT ANY WARRANTY; without even the implied warranty of
		MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
	</p>

	<p>
		Download the latest release 
		from <a href=http://quitte.de/dsp/caps.html>the caps homepage</a>.
	</p>

	&nbsp;<br>

	<a name=Installation><h3>Installation</h3></a>

	<p>
		Provided you run Linux, 
		installation is simply:
	</p>

	<pre align=left>
$ tar xvfz caps_0.3.0.tar.gz&nbsp;
$ cd caps-0.3.0&nbsp;
$ make
$ su
# make install</pre>
	
	<p>
		You should now be able use the plugins from the collection
		in any LADSPA-aware host program, 
		like the wonderful <a href=http://pure-data.org>pd</a> with
		the <code>plugin~</code>
		<a href=http://pure-data.sourceforge.net/>external</a>,
		the inimitable <a href=http://jack-rack.sourceforge.net/>jack-rack</a>,
		the impressive <a href=http://ardour.org>ardour</a>,
		the versatile <a href=http://eca.cx>ecasound</a>,
		the classic <a href=http://www-ccrma.stanford.edu/software/snd/>snd</a>,
		and numerous other applications large and small.
	</p>
	
	<p>
		You don't run Linux? Why not
		<a href=http://www.debian.org>downgrade now</a>?
	</p>
	
	<p>
		PPC and other non-x86 users might have to edit the 
		Makefile. Patches welcome.
	</p>

	<p>
		In its current state, caps will not work on OSX.
	</p>
	
	<h5>Troubleshooting</h5>
	<p>
		With no external dependencies, compiling caps should rarely fail. If it
		does on your machine, please send the output of the <tt>make</tt> 
		command so we can try and fix the problem.
	</p>
	
	<p>
		Thanks to all members of the Linux audio development mailing list
		who helped sort out some compilation problems on more recent systems.
	</p>

	<h5>Bugs</h5>
	<p>
		If any of the plugins in the suite do not work with your host program
		of choice, or don't work as advertised, please 
		<a href=mailto:tim@quitte.de?subject=caps-bug>send a bug report</a>.
	</p>

	&nbsp;<br>

	<!-- ------------------------------------------------------------------ ->

	<a name=WhatYouShouldKnow><h3>What You Should Know</h3></a>

	<h5>Sample Rate Dependencies</h5>
	<p>
		In the plugin listing, for every unit you'll see a note like 
		<em>All sample rates</em>. This means that the plugin should sound the
		same no matter what sample rate it is run at. If it doesn't, please
		send a bug report. A note like <em>44.1 kHz only</em> means you
		can still run the plugin at other sample rates, but the sonic 
		experience will be different.
	</p>

	<h5>Parameter Smoothing</h5>
	<p>
		To prevent 'zipper' noise, control parameters are subject to internal 
		smoothing where the effort seems justified. This includes all 'gain'
		and 'volume' knobs and the <a href=#Eq>Eq</a> band adjustments, as
		well as all (I think) LFO rate adjustments. The time interval for
		the resulting parameter sweep is equal to the block size (length
		of the signal that is processed per cycle).
	</p>
	
	<h5>Realtime Use</h5>
	<p>
		All of the plugins in the suite are hard-realtime capable. In some
		cases, parameter smoothing will take a marginal number of
		extra CPU cycles when a control value is changed.
	</p>

	<h5>In-Place and Mixing/Replacing Operation</h5>
	<p>
		All of the plugins in the suite support any combination of in-place, 
		mixing and replacing operation.
	</p>

	<h5>Denormal Protection</h5>
	<p>
		As you may know, most of the common general-purpose processors, 
		most notably the Intel and AMD makes, have a weakness 
		computing exponential decay (of which many of the plugins in this and
		other collections
		make use). When working with numbers very close to zero ('denormals'), 
		these processors spend
		ridiculous amounts of time trying to maintain a specific idea of precision
		("I won't admit this number is zero").
		Unfortunately, there is no way to tell these processors to simply 
		accept zero as the answer. You see, these little chips are very proud
		and won't admit their computing precision is finite.
	</p>
	<p>
		In order to prevent this 'denormal detour', some of 
		the plugins in the suite
		add a very small fixed value to the signals processed. 
		The number is flipped around
		zero, sometimes for every sample, sometimes for every block processed; 
		thus, an inaudible (-266 dB) square wave results.
	</p>
	<p>
		In realtime operation, you'll simply not notice. When running 
		over a really huge continuous block of audio 
		in one go, 
		your processing network might suffer from marginal DC build-up
		through those plugins that flip per block. Still inaudible (and probably
		not even detectable to measurement), and
		chances are you won't notice either; it just seems worth noting.
	</p>

	<h5>Default Parameters</h5>
	<p>
		In some cases,
		the LADSPA specification 
		does not provide 
		the means for expressing an intended default parameter value without 
		seriously narrowing the range of possible values for that parameter. 
		In such cases, I have tried to find a compromise, keeping in mind
		that it is easier for the user to override the default than to change
		the source and recompile.
	</p>
	
	<h5>Plugin Activation &amp; Parameters</h5>
	<p>
		Prior to processing, LADSPA plugins are 'activated' by the host program.
		The caps plugins use this opportunity to initialize their internal state
		to the current control settings. The purpose is to prevent an unwanted
		parameter	smoothing sweep in the first processing call after activation
		(which, in an 'offline' host like an audio editor, may span a few seconds
		or even minutes of audio).
	</p>
	<p>
		I have heard second-hand that host programs exist which activate a plugin
		without initializing parameters first. To prevent problems with such
		hosts, the caps plugins default to using a control's lower bound if the
		control hasn't been set up yet. As a result, the first block processed 
		<em>will</em> be done with sweeping parameters. The alternative of
		checking every block to process whether it is the first since activation
		and act accordingly is highly unattractive from a number of perspectives,
		performance being one of them.
	</p>
	<p>
		I consider host programs acting as described above
		<em>broken</em>. If you use a host that does 'work' like this and are
		irritated by the behaviour, please direct complaints to the host program's
		author.
	</p>
	
	<h5>You Can Help!</h5>
	<p>
		If you like to, you can both help in the development and help the 
		developer of caps. Your feedback is wanted, patches are welcome
		and donation offers will not be turned down.
	</p>
	
	<h5>Known Bugs and Limitations</h5>
	<ul>
		<li>
			Processing blocks larger than 2<sup>31</sup> - 1 aren't supported.
		</li>
		<li>
			Oversampling consumes a lot of cycles. 
		</li>
	</ul>

	&nbsp;<br>

	<!-- ------------------------------------------------------------------ ->

	<a name=ThePlugins><h3>The Plugins</h3></a>
	<p>
		These are the plugins in the suite:
	</p>
	
		<ul type=square style=margin-top:2pt;>
			<li><a href=#Generic>Generic</a></li><ul type=circle>
				<li><a href=#Eq>Eq</a> - classic ten-band equalizer</li>
				<li><a href=#Compress>Compress</a> - a compressor suitable for single instruments</li>
				<li><a href=#Pan>Pan</a> - pan and optional width</li>
			</ul>
			<li><a href=#Emulation>Emulation</a></li><ul type=circle>
				<li><a href=#PreampIII>PreampIII</a> - emulation of a tube preamplifier circuit</li>
				<li><a href=#PreampIV>PreampIV</a> - tube preamplifier with tone controls</li>
				<li><a href=#AmpIII>AmpIII</a> - emulation of a tube amplifier</li>
				<li><a href=#AmpIV>AmpIV</a> - tube amplifier with tone controls</li>
				<li><a href=#AmpV>AmpV</a> - refined tube amplifier emulation</li>
				<li><a href=#CabinetI>CabinetI</a> - emulation of classical speaker cabinets</li>
				<li><a href=#CabinetII>CabinetII</a> - refined version of CabinetI</li>
				<li><a href=#Clip>Clip</a> - hard 'transistor' clipping</li>
			</ul>
			<li><a href=#Effects>Effects</a></li><ul type=circle>
				<li><a href=#ChorusI>ChorusI</a> - a versatile classic</li>
				<li><a href=#StereoChorusI>StereoChorusI</a> - when one channel is not enough</li>
				<li><a href=#ChorusII>ChorusII</a> - variant with fractal modulation</li>
				<li><a href=#StereoChorusII>StereoChorusII</a> - stereo variant with fractal modulation</li>
				<li><a href=#PhaserI>PhaserI</a> - another classic</li>
				<li><a href=#PhaserII>PhaserII</a> - variant with fractal modulation</li>
				<li><a href=#SweepVFI>SweepVFI</a> - resonant filter modulated by a fractal</li>
				<li><a href=#SweepVFII>SweepVFII</a> - resonant filter modulated by a fractal</li>
				<li><a href=#Scape>Scape</a> - stereo delay plus resonant filters, fractal modulation</li>
			</ul>
			<li><a href=#Generators>Generators</a></li><ul type=circle>
				<li><a href=#VCOs>VCOs</a> - sawtooth / triangle / square wave generator</li>
				<li><a href=#VCOd>VCOd</a> - double VCO with detune and hard sync</li>
				<li><a href=#CEO>CEO</a> - chief executive oscillator</li>
				<li><a href=#Sin>Sin</a> - testing and tuning helper</li>
				<li><a href=#White>White</a> - white noisz</li>
				<li><a href=#Lorenz>Lorenz</a> - a fractal singing in a broken voice</li>
				<li><a href=#Roessler>Roessler</a> - a roaring fractal</li>
			</ul>
			<li><a href=#Reverb>Reverb</a></li><ul type=circle>
				<li><a href=#JVRev>JVRev</a> - a digital reverb technology classic</li>
				<li><a href=#Plate>Plate</a> - versatile refined digital reverb</li>
				<li><a href=#Plate2x2>Plate2x2</a> - 2-in, 2-out version of Plate</li>
			</ul>
			<li><a href=#Others>Others</a></li><ul type=circle>
				<li><a href=#Click>Click</a> - practice, practice, practice!</li>
				<li><a href=#Dirac>Dirac</a> - one-sample impulse generator</li>
				<li><a href=#HRTF>HRTF</a> - head-related transfer function</li>
			</ul>
		</ul>
	<a name=Generic><h3>Generic</h3></a>

	<a name=Eq><h4>Eq</h4></a>

	<p>
		A ten-band, octave-spread equalizer. High individual band gains can
		cause phase cancellation (comb filtering).
	</p>
	<p>
		<em>All sample rates (bands beyond Nyquist are disabled).</em>
	</p>
	<ul>
		<li><b>31 Hz, 63 Hz, 125 Hz, 250 Hz, 500 Hz, 1 kHz, 2 kHz, 4 kHz, 8 kHz, 16 kHz</b></li>
			control the gain in dB for the respective band.</p></li>
	</ul>

	<a name=Compress><h4>Compress</h4></a>

	<p>
		A mono compressor, based on the SC1 design by 
		<a href=http://plugin.org.uk>Steve Harris</a> (in other words, a ripoff)
		with minor tweaks. Be
		careful with the gain and ratio controls, the output signal can easily
		exceed 0 dB.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>gain (dB)</b><p>
			controls the maximum gain applied by the unit.</p></li>
		<li><b>ratio (1:n)</b><p>
			controls the overall gain.</p></li>
		<li><b>attack (s)</b><p>
			controls the speed at which the circuit acts on a rising input signal
			envelope.</p></li>
		<li><b>release (s)</b><p>
			controls the speed at which the circuit acts on a decaying input signal
			envelope.</p></li>
		<li><b>threshold (dB)</b><p>
			sets the envelope level that the compressor starts acting at.</p></li>
		<li><b>knee radius (dB)</b><p>
			controls the softness of the transition between unaltered and 
			compressed signal.</p></li>
	</ul>

	<a name=Pan><h4>Pan</h4></a>
	<p>
		Places a monaural source in the stereo field. For some extra spicing,
		the unit can also add a low-pass filtered echo at the far
		ends of the stereo field to make the signal sound 'wider' (recreating 
		the old doubling effect with a twist). You can 
		(and should!) control the loudness and timing of the echo; what's best
		depends largely on the source signal.
	</p>
	<p>
		<em>No parameter smoothing.</em>
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>pan</b><p>
			position</p></li>
		<li><b>width</b><p>
			echo volume</p></li>
		<li><b>t</b><p>
			delay in milliseconds<p></li>
		<li><b>mono</b><p>
			if non-zero, causes the unit to mix the stereo output back down to mono
			and output that (on both outbound ports). 
			The purpose is to check for mono
			compatibility of the output.<p></li>
	</ul>

	<a name=Emulation><h3>Emulation</h3></a>

	<a name=PreampIII><h4>PreampIII</h4></a>
	<p>
		One further step in the evolution of my 
		<a href=http://quitte.de/dsp/preamp.html>tube preamplifier emulation</a>. This one
		uses conventional polyphase FIR filters for 8x oversampling,
		which helps make the unit sound a good deal cleaner than the 
		IIR-based predecessor. 
	</p>
	<p>
		The first steps towards this unit were based on a <tt>spice</tt> model
		of the preamplifier circuit in a Fender 5F4 design ('Super' tube amp,
		a close relative of the famed 'Bassman', which is the ancestor of the
		Marshall lineage). Further evolution was 
		based on measurements of my 'Super 60' (mid-1980s) amp and, of course, 
		personal preference. 
		The plugin offers a softer kind of preamp clipping
		than the actual circuit, though it can be made to clip as harsh as the 
		original thing if given enough gain.
	</p>
	<p>
		A word of caution: at high 'temperature' settings, an input
		signal peaking above 0 dB can drive
		the first 'tube' stage into hard clipping. Since this stage of the
		circuit is run at the nominal sample rate, aliasing and thus sound
		quality degradation will occur.
		Do not overdrive the input, instead use the 'gain' knob for 
		harsh distortion, it offers more than enough of it. This applies to all
		Preamp and Amp units.
	</p>
	<p><em>All sample rates.</em></p>
	<ul>
		<li><b>gain</b><p>
				controls the level of saturation. For a balanced (0 dB max.) 
				input signal,
				hard clipping will not occur below a gain value of 1.
			</p></li>
		<li><b>temperature</b><p>
				emulates the level of the input signal, thus how much the first 
				preamplifier tube will colour the signal. 
				The effect is very subtle.</p></li>
	</ul>

	<a name=PreampIV><h4>PreampIV</h4></a>
	<p>
		A variation on <a href=#PreampIII>PreampIII</a> with added tone controls
		before the clipping stage. The tone controls have the same
		flaws as their analog counterparts (phase cancellation at high band
		gains). But exactly because they are not linear-phase, they are quite
		useful in altering the distortion characteristics of the circuit.
	</p>
	<p><em>All sample rates.</em></p>
	<p>
		Same parameters as <a href=#PreampIII>PreampIII</a>, plus the following 
		(all in dB units):
	</p>
	<ul>
		<li><b>bass</b><p>
				80 Hz band</p></li>
		<li><b>mid</b><p>
				300 Hz band</p></li>
		<li><b>treble</b><p>
				1200 Hz band</p></li>
		<li><b>hi</b><p>
				4800 Hz band</p></li>
	</ul>

	<a name=AmpIII><h4>AmpIII</h4></a>
	<p>
		A <a href=#PreampIII>PreampIII</a> circuit plus a tube power amplifier 
		emulation giving that smooth drive. For an even warmer tone, look at
		the <a href=#AmpV>AmpV</a> unit.
	</p>
	<p><em>All sample rates.</em></p>
	<p>
		Same controls as <a href=#PreampIII>PreampIII</a>, plus:
	</p>
	<ul>
		<li><b>drive</b><p>
				controls the 'master volume' of the circuit, i.e. how much
				coloring and compression the emulated power amplifier produces.</p></li>
	</ul>

	<a name=AmpIV><h4>AmpIV</h4></a>
	<p>
		A <a href=#PreampIV>PreampIV</a> with the same output amp stage
		emulation that <a href=#AmpIII>AmpIII</a> employs. Controls are the
		same as on <a href=#PreampIV>PreampIV</a>, plus the 'drive' inherited
		from <a href=#AmpIII>AmpIII</a>.
	</p>
	<p><em>All sample rates.</em></p>

	<a name=AmpV><h4>AmpV</h4></a>
	<p>
		The latest (and greatest!) in my ongoing quest for high quality 
		guitar amplifier emulation.
		I'm tempted to say that this one sounds better than most of the real 
		tube amplifiers I have had the pleasure to play.
	</p><p>
		The circuit is loosely based on the <a href=#AmpIII>AmpIII</a> design. 
		Also, the preamplifier stage has been augmented and tuned 
		to provide a warmer frequency response as well as slightly different
		clipping characteristics. But more significantly, AmpV emulates the 
		shortcomings of an unregulated power supply and their effect on the 
		total gain of the circuit, the operating point of the tubes and the
		clipping response.
	</p><p>
		AmpV's forte is a clean but very mellow sound, at lowish 'gain' settings
		and moderate 'watts'. 
	</p><p>
		Use this plugin followed by a <a href=#CabinetII>CabinetII</a> for complete
		guitar (or bass guitar) amplifier and speaker emulation.
	</p>
	<p><em>All sample rates.</em></p>
	<ul>
		<li><b>gain</b><p>
				controls the amount of edge added in the preamplifier stage. The
				parameter mapping has been optimized for fine control in the clean to 
				medium-rough range.
				</p></li>
		<li><b>bass</b><p>
				controls the attenuation or amplification of low frequencies
				before the preamp tube (the value is expressed in dB). 
				Technically, a low-shelving equalizer filter.
				</p></li>
		<li><b>tone</b><p>
				controls post-preamplifier circuit filtering. At the zero setting,
				the effect is turned off. At its maximum, there is some resonance
				quite high in the spectrum.
				</p></li>
		<li><b>drive</b><p>
				controls power-amplification stage saturation, which gives a fair bit
				of warmth and some compression. 
				</p></li>
		<li><b>watts</b><p>
				controls how capable the emulated power supply is. At its minimum
				setting, the effects of supply voltage modulation are
				the most pronounced.
				At the maximum setting, they are effectively removed (which is 
				recommended for high-'gain' setups).
				</p></li>
	</ul>

	<a name=CabinetI><h4>CabinetI</h4></a>

	<p>
		A collection of filters emulating the frequency response
		of various guitar amplifier 
		combos, in the vein of my 
		<a href=http://quitte.de/dsp/unmatched.html>previous efforts</a>.
	</p>
	<p>
		(You'll find a more exact, but also a lot more cycle-hungry and
		latency-inflicting rendering of 
		these responses in 
		<a href=http://plugin.org.uk>Steve Harris' collection</a>, from which
		they were borrowed).
	</p>
	<p>
		When used together with one of the Preamp/Amp units, emulation of all 
		major sonic features of a guitar/bass amplifier is complete.
	</p>
	<p>
		<b>Please note</b> that unless you have very tight CPU usage requirements
		using the successor unit, <a href=#CabinetII>CabinetII</a>, 
		is recommended.
	</p>
	<p>
		<em>44.1 kHz (48 kHz gives a slightly different, but still usable frequency response.)</em>
	</p>
	<ul>
		<li><b>model</b><p>
			0 - identity filter (what goes in, goes out).<br>
			1 - 'unmatched', as I still like to call it. A Matchless Chieftain.<br>
			2 - the same, but the recording was taken with the microphone on-axis.<br>
			3 - Superchamp (a Fender, isn't it?)<br>
			4 - Fender Vibrolux 68<br>
			5 - Marshall 'Plexi'
		</li>
		<li><b>gain (dB)</b><p>
			volume control.</p></li>
	</ul>

	<a name=CabinetII><h4>CabinetII</h4></a>

	<p>
		A refined version of <a href=#CabinetI>CabinetI</a>. 
		This version offers a much more
		faithful rendering of the original speaker cabinet frequency responses
		due to a modified filter approximation, double the filter order and
		(limited) adaptability to sample rate.
	</p><p>
		Unlike conventional impulse response emulators who rely on brute-force
		convolution, FFT-based algorithms or the patent-encumbered zero-latency
		variant of the latter, the Cabinet units employ IIR filters for
		truly resonant behaviour. As a result, their sound is more lively.
	</p><p>
		Same controls as <a href=#CabinetI>CabinetI</a>.
	</p>
	<p>
		<em>44.1, 48, 88.2 and 96 kHz (nearest match chosen at runtime)</em>
		<br>
	</p>

	<a name=Clip><h4>Clip</h4></a>
	<p>
		A spin-off of the <a href=#PreampIII>PreampIII</a> effort.
		8x oversampled hard clipping (sometimes called 'diode' or 
		'transistor' clipping). 
		The clip threshold is fixed at -1 dB (overshoot 
		from the up- and downsampling filters could exceed 0 dB were the threshold
		higher). 
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>gain (dB)</b><p>
			controls pre-clipping amplification.</p></li>
	</ul>

	<a name=Effects><h3>Effects</h3></a>

	<a name=ChorusI><h4>ChorusI</h4></a>

	<p>
		Mono version, with a feedback circuit. The parameter range suits more
		subtle effects as well as all-out flanging. Modifying the 't' parameter
		when 'feedback' is non-zero will cause zipper noise.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>t (ms)</b><p>
			delay time.</p></li>
		<li><b>width (ms)</b><p>
			controls the amount of pitch change.</p></li>
		<li><b>rate (Hz)</b><p>
			the speed of the pitch modulation.</p></li>
		<li><b>blend</b><p>
			the amount of dry and fed-back signal in the output.</p></li>
		<li><b>feedforward</b><p>
			amount of modulated signal in the output.</p></li>
		<li><b>feedback</b><p>
			amount of signal with fixed delay in the modulation input.</p></li>
	</ul>
	
	<a name=StereoChorusI><h4>StereoChorusI</h4></a>

	<p>
		Two <a href=#ChorusI>ChorusI</a> circuits in parallel, 
		sharing the same input (and delay 
		line). Same parameters as the mono version, plus one.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>phase</b></li><p>
			controls the relation of the two LFOs. 0 means in-phase, 0.5 is
			quadrature, and 1 is anti-phase.</p>
		</li>
	</ul>

	<a name=ChorusII><h4>ChorusII</h4></a>

	<p>
		A variation on the <a href=#ChorusI>ChorusI</a> unit; this one employs
		a Roessler fractal to steer the signal modulation, resulting in less
		predictable and thus more interesting sound.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>t (ms)</b><p>
			delay time.</p></li>
		<li><b>width (ms)</b><p>
			controls the amount of pitch change.</p></li>
		<li><b>rate</b><p>
			the speed of the pitch modulation.</p></li>
		<li><b>blend</b><p>
			the amount of dry and fed-back signal in the output.</p></li>
		<li><b>feedforward</b><p>
			amount of modulated signal in the output.</p></li>
		<li><b>feedback</b><p>
			amount of signal with fixed delay in the modulation input.</p></li>
	</ul>
	
	<a name=StereoChorusII><h4>StereoChorusII</h4></a>

	<p>
		Two <a href=#ChorusII>ChorusII</a> circuits in parallel, 
		sharing the same input (and delay
		line). Same parameters as the mono version.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>

	<a name=PhaserI><h4>PhaserI</h4></a>

	<p>
		Nothing out of the ordinary, just a phaser like I like to have them.
		A phaser unit works by sweeping notches in the frequency response; this one
		has six comb filters, for six notches. 
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>rate (Hz)</b><p>
			controls the speed of the modulation.</p></li>
		<li><b>depth</b><p>
			the strength of the effect.</p></li>
		<li><b>spread</b><p>
			the distance of the notched frequency bands.</p></li>
		<li><b>feedback</b><p>
			controls the amount of resonance.</p></li>
	</ul>
			
	<a name=PhaserII><h4>PhaserII</h4></a>

	<p>
		A variation of the <a href=#PhaserI>PhaserI</a> circuit which relies
		on a Lorenz fractal for the modulation source, improving hugely on
		output sound variation.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>rate</b><p>
			controls the speed of the modulation.</p></li>
		<li><b>depth</b><p>
			the strength of the effect.</p></li>
		<li><b>spread</b><p>
			the distance of the notched frequency bands.</p></li>
		<li><b>feedback</b><p>
			controls the amount of resonance.</p></li>
	</ul>
			
	<a name=SweepVFI><h4>SweepVFI</h4></a>

	<p>
		A resonant filter whose cutoff frequency is swept by a 
		<a href=#Lorenz>Lorenz</a> fractal. With the default parameters 
		(moderate Q, cutoff around 800 Hz and band pass mode)
		it makes a nice Wah effect if you lower the 'h' parameter by a fair amount.
	</p>
	<p>
		Another idea is to set it to very high Q and frequency in low pass mode
		and filter some noise, for synthetic bird chirping (high h value)
		or theremin-like sounds (low h, lower frequency).
	</p>
	<p>
		Please note that the most useful settings for the 'h' parameter
		are <i>very</i> low, around 0.01 - 0.09. Unfortunately there's no way
		to provide a default setting as low as this without compromising
		the range of the control.
	</p>
	<p>
		And be careful, high Q resonance can peak at up to +18 dB.
	</p>
	<p>
		<em>All sample rates (modulation rate and character are sample rate dependent).</em>
	</p>
	<ul>
		<li><b>f</b><p>
			cutoff frequency (band center for band pass filtering).</p></li>
		<li><b>Q</b><p>
			filter resonance.</p></li>
		<li><b>mode</b><p>
			0 - low pass<br>
			1 - band pass</p></li>
		<li><b>depth:x</b></li>
		<li><b>depth:y</b></li>
		<li><b>depth:z</b><p>
			control how the modulation is mixed from the state of the attractor.</p></li>
		<li><b>h</b><p>
			step size of the fractal.</p></li>
	</ul>
		
	<a name=SweepVFII><h4>SweepVFII</h4></a>

	<p>
		A variation on <a href=#SweepVFI>SweepVFI</a>, 
		with the filter Q (bandwidth/resonance) 
		modulated by a second	<a href=#Lorenz>Lorenz</a> fractal. 
	</p>
	<p>
		Please note that the most useful settings for the 'h' parameter
		are <i>very</i> low, around 0.01 - 0.09. Unfortunately there's no way
		to provide a default setting as low as this without compromising
		the range of the control.
	</p>
	<p>
		And be careful, high Q resonance can peak at up to +18 dB.
	</p>
	<p>
		<em>All sample rates (modulation rate and character are sample rate dependent).</em>
	</p>
	<ul>
		<li><b>f</b><p>
			cutoff frequency (band center for band pass filtering).</p></li>
		<li><b>Q</b><p>
			filter resonance.</p></li>
		<li><b>mode</b><p>
			0 - low pass<br>
			1 - band pass</p></li>
		<li><b>f:depth:x</b></li>
		<li><b>f:depth:y</b></li>
		<li><b>f:depth:z</b><p>
			control how the filter cutoff modulation is mixed 
			from the state of the attractor.</p></li>
		<li><b>f:h</b><p>
			step size of the fractal modulating the cutoff.</p></li>
		<li><b>Q:depth:x</b></li>
		<li><b>Q:depth:y</b></li>
		<li><b>Q:depth:z</b><p>
			control how the filter Q modulation is mixed 
			from the state of the attractor.</p></li>
		<li><b>Q:h</b><p>
			step size of the fractal modulating filter Q.</p></li>
	</ul>

	<a name=Scape><h4>Scape</h4></a>

	<p>
		This plugin will generate quite expansive soundscapes from even the
		most modest input signals.
	</p>
	<p>
		Technically, 'Scape' is a 
		stereo delay, with the panning of the echo modulated by a pair fractals.
		The delay times are adjustable through
		a 'bpm' knob, augmented by a beat division parameter. 
		The input as well as the delayed signals are processed by a
		collection of resonant filters, with frequency and cutoff modulated
		in sync to the current tempo.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>bpm</b><p>
			beats per minute.</p></li>
		<li><b>divider</b><p>
			controls whether the groove is ternary or binary.</p></li>
		<li><b>feedback</b><p>
			controls the length of the delay tail.</p></li>
		<li><b>dry</b><p>
			the amount of dry signal mixed to the outputs.</p></li>
		<li><b>blend</b><p>
			the amount of wet signal mixed to the outputs.</p></li>
	</ul>



	<a name=Generators><h3>Generators</h3></a>

	<a name=VCOs><h4>VCOs</h4></a>

	<p>
		An oscillator capable of producing the standard 
		triangle, sawtooth and square waveforms of analog fame, 
		and almost any conceivable blend
		thereof. 8x oversampled, thus needs a lot of cycles. Sorry about that,
		but you don't get the flexibility and fat sound for free.
	</p>
	<p>
		About the morphing controls:
	</p>
	<ul type=circle>
		<li>For a <b>triangle wave,</b> set both <i>tri .. saw</i> and
			<i>~ .. square</i> to 0 (this is the default setting).</li>
		<li>To morph into a <b>sawtooth,</b> pull up <i>tri .. saw</i>.</li>
		<li>For a <b>square wave</b> instead, pull up <i>~ .. square</i>. When
			the value reaches 1, <i>tri .. saw</i> fully controls the pulse
			width.</li>
	</ul>
	<p>
		For a more intuitive approach, thinking of both controls
		in terms of 'dull .. sharp' for a start
		can't hurt.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>f</b><p>
			the frequency.</p></li>
		<li><b>tri .. saw</b><p>
			controls the morph between triangle and sawtooth, and the pulse
			width of square oscillation.</p></li>
		<li><b>~ .. square</b><p>
			controls the morph between triangle/sawtooth and square wave.</p></li>
		<li><b>volume</b></li>
	</ul>

	<a name=VCOd><h4>VCOd</h4></a>

	<p>
		A combination of two <a href=#VCOs>VCOs</a> units. 
		The second oscillator
		offers a separate tuning knob. It can also be made 
		to 'hard sync'
		to the first unit, which means that when the first has completed
		a wave cycle, the second is forced to restart its wave cycle 
		together with the first. 
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>f</b><p>
			the frequency.</p></li>
		<li><b>1: tri .. saw</b></li>
		<li><b>1: ~ .. square</b><p>
			waveform morph controls for the first oscillator.</p></li>
		<li><b>2: tri .. saw</b></li>
		<li><b>2: ~ .. square</b><p>
			waveform morph controls for the second oscillator.</p></li>
		<li><b>2: tune</b><p>
			controls the interval between the two oscillator frequencies, in
			units of (fractional) semitones.</p></li>
		<li><b>sync</b><p>
			if non-zero, puts the second oscillator into 'hard sync' mode, and
			determines the forced-restart offset into its wave cycle.</p></li>
		<li><b>blend</b><p>
			controls how the waveforms from the two oscillators are mixed.
			A value of 0 means only oscillator one is heard, a value of either
			1 or -1 tilts the balance fully towards oscillator two. The sign
			of the <b>blend</b> value determines if the signals are added or
			subtracted.</p></li>
		<li><b>volume</b></li>
	</ul>

	<a name=CEO><h4>CEO</h4></a>

	<p>
		The Chief Executive Oscillator forever repeats the word 'money'.
	</p>
	<p>
		<em>44.1 kHz.</em>
	</p>
	<ul>
		<li><b>mpm</b><p>
			moneys per minute.</p></li>
		<li><b>volume</b></li>
		<li><b>damping</b><p>
			moderates the CEO.</p></li>
	</ul>

	<a name=Sin><h4>Sin</h4></a>

	<p>
		The old friend, indispensable for testing and tuning.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>f</b><p>
			the frequency.</p></li>
		<li><b>volume</b></li>
	</ul>

	<a name=White><h4>White</h4></a>

	<p>
		White noise.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>volume</b></li>
	</ul>

	<a name=Lorenz><h4>Lorenz</h4></a>

	<p>
		A Lorenz attractor is a fractal system. It produces a very
		own character of noisz that will hardly repeat in the course of your
		lifetime.
	</p>
	<p>
		<em>Sound varies with sample rate.</em>
	</p>
	<ul>
		<li><b>h</b></p>
			controls the step size of the state progression, and, indirectly, the
			perceived frequency of the sound.</p></li>
		<li><b>x</b></li>
		<li><b>y</b></li>
		<li><b>z</b><p>
			control how the signal is mixed from the state of the attractor.</p></li>
		<li><b>volume</b></li>
	</ul>
	<p>
		For more information on the
		Lorenz and Roessler attractors, visit
		<a href=http://astronomy.swin.edu.au/~pbourke/fractals/lorenz/>Paul Bourke's resourceful site</a>.
	</p>

	<a name=Roessler><h4>Roessler</h4></a>

	<p>
		Another fractal system. This one lends itself
		particularly well to sweeping the 'h' parameter.
	</p>
	<p>
		<em>Sound varies with sample rate.</em>
	</p>
	<ul>
		<li><b>h</b></p>
			controls the step size of the state progression.</p></li>
		<li><b>x</b></li>
		<li><b>y</b></li>
		<li><b>z</b><p>
			control how the signal is mixed from the state of the attractor.</p></li>
		<li><b>volume</b></li>
	</ul>
	<p>
		For more information on the
		Lorenz and Roessler attractors, visit
		<a href=http://astronomy.swin.edu.au/~pbourke/fractals/lorenz/>Paul Bourke's resourceful site</a>.
	</p>

	<a name=Reverb><h3>Reverb</h3></a>

	<a name=JVRev><h4>JVRev</h4></a>

	<p>
		A traditional Chowning/Moorer/Schroeder reverb, it sounds quite good
		for a reverberation unit with such a comparatively small footprint
		(only a few years ago, your average personal computer wasn't even capable
		of computing this in realtime!). A quite
		straight-forward rewrite of a unit found in 
		<a href=http://www-ccrma.stanford.edu/>CCRMA</a>'s 
		<a href=http://www-ccrma.stanford.edu/software/stk/>STK (Synthesis Toolkit)</a>,
		with minor tweaks.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>t60 (s)</b></p>
			controls the time until the reverb tail is supposed to fade 
			to -60 dB.</p></li>
		<li><b>blend</b></p>
			controls dry/wet mixing ratio.</p></li>
	</ul>

	<a name=Plate><h4>Plate</h4></a>

	<p>
		A reverberation unit based on the design discussed
		in [<a name=dat97-1-1 href=#dat97-1>1</a>]. 
		Unlike the reference, the unit employs cubic instead of
		allpass interpolation to modulate the reverb 'tank' delay lines.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>bandwidth</b><p>
			controls damping of the input signal before it enters the
			delay circuits.</p></li>
		<li><b>tail</b><p>
			controls the length of the reverb tail.</p></li>
		<li><b>damping</b><p>
			controls attenuation of high frequency components within the reverb 'tank'
			(decay stage).</p></li>
		<li><b>blend</b><p>
			dry/wet mixing ratio (default should be 1/8, not 1/4).</p></li>
	</ul>

	<a name=Plate2x2><h4>Plate2x2</h4></a>

	<p>
		By popular demand, a stereo-in, stereo-out version of the 
		<a href=#Plate>Plate</a> reverb unit. Same controls, same sound.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>

	<a name=Others><h3>Others</h3></a>

	<a name=Click><h4>Click</h4></a>

	<p>
		A sample-accurate metronome. Timing is exact at any sample rate, but
		the pitch of the click (being a recorded sample) will vary. (The click
		also lends well for testing reverb plugins.)
	</p>
	<p>
		<em>44.1 kHz.</em>
	</p>
	<ul>
		<li><b>bpm</b><p>
			beats per minute.</p></li>
		<li><b>volume</b></li>
		<li><b>damping</b><p>
			controls the softness of the click sound.</p></li>
	</ul>

	<a name=Dirac><h4>Dirac</h4></a>

	<p>
		This plugin produces periodic impulses of exactly one sample width 
		(as long as the 'damping' control is left at the default 0 setting).
		It's probably only useful for testing and basic impulse response
		retrieval; don't use this plugin if you don't know what you're doing,
		your amplification hardware and speakers will thank you. 
		The 'volume' control defaults to silent output to spare you nasty
		surprises.
	</p>
	<p>
		<em>All sample rates.</em>
	</p>
	<ul>
		<li><b>ppm</b><p>
			pulses per minute.</p></li>
		<li><b>volume</b></li>
		<li><b>damping</b></li>
	</ul>

	<a name=HRTF><h4>HRTF</h4></a>

	<p>
		Applying the head-related transfer function to a signal makes it appear
		to come from a specific direction in space. This plugin applies the
		HRTF with custom-shaped IIR filters. 
		Tell me how it works for you (you should
		have pretty good headphones to get the full effect). 
	</p>
	<p>
		The HRTF impulse response data has been collected and prepared 
		by MIT's Media Lab.
	</p>
	<p>
		This unit only utilizes the 0-elevation set (sound source is level
		with the listener).
	</p>
	<p>
		<em>44.1 kHz.</em>
	</p>
	<ul>
		<li><b>pan</b><p>
			The position, in integer steps. Some noteworthy settings:
			<ul>
				<li>
					0 = in front</li>
				<li>+18 = left,</li>
				<li>-18 = right, and</li>
				<li>-36 = +36 = behind the listener.</li>
			</ul>
		</li>
	</ul>

	&nbsp;<br>

	<a name=Appendix><h3>Appendix</h3></a>

	<a name=DataSheet><h4>Plugin Data Sheets</h4></a>

	<p>
		An accompanying data sheet collection has been compiled. For each
		plugin, it shows:
	</p>
	<ul type=circle>
		<li>the plugin ID</li>
		<li>normalized sample output from the plugin 
			with default parameter settings 
			(in the filter case, this is an impulse response)</li>
		<li>a frequency magnitude plot for the sample output</li>
		<li>estimated CPU usage on my box</li>
		<li>latency information if applicable</li>
		<li>audio routing information</li>
		<li>the control inputs on the plugin</li>
	</ul>
	<p>
		You can fetch the data sheet compilation
		<a href=http://quitte.de/dsp/caps-0.3.0.pdf>from the caps homepage</a>.
	</p>
	
	<a name=Changelog><h4>Changelog</h4></a>

	<pre>
0.3.0
  * TwelveAX7_3 changed to clip slightly early in the upper lobe
  * Scape plugin added
  * plugin names rewritten, prefixed with "CAPS:"
  * new ChorusII, StereoChorusII plugins
  * Chorus, StereoChorus relabeled, appended 'I' suffix
  * new PhaserII plugin (great stuff if I may say so)
  * Phaser relabeled, appended 'I' suffix
  * new AmpV plugin, based on AmpIII, emulates compression and distortion
    modulation through power supply shortcomings, plus lots of fine-tuning
    and an additional biquad. We're getting there!
  * all Preamp and Amp models fitted with a new 12AX7 model, linear
    interpolation of a sample table obtained from spice simulation

0.2.4
  * feedback default reverted to 0 for the Chorus units
  * fixed Cabinet to switch to correct gain at 'model' control change
  * fixed 'model' control in Cabinet to work with a broader range of hosts
  * Cabinet name changed to CabinetI
  * CabinetII plugin: Cabinet with 32nd order IIR filters, more fidelity
    to the original frequency responses, supplied coefficients for 4 of the
    most used sample rates
  * applied the gcc-4 enabling patch
  * SweepVF renamed to SweepVFI
  * new SweepVFII plugin, variant of SweepVFI with Q modulated by a 
    second Lorenz fractal
  * dsp/exp2 dumped in favour of libm's exp2(3)

0.2.3
  * StereoChorus denormal protection made functional 
    (Thanks again to S. Savolainen)
  * Phaser denormal protected
  
0.2.2
  * Build was _not_ fixed for g++-4.0.
  * AmpIV gain control restored to operate as expected
  * Chorus/StereoChorus denormal protection (thanks to S. Savolainen)
  * a few cosmetic changes elsewhere
  
0.2.1
  * Build fixed for g++-4.0, PPC and AMD64 
    (Thanks to Niklas Werner, Andreas Jochens and Mario Lang)
  * Reverb.* cosmetics
  * AmpIV tone controls moved to after initial tube transfer

0.2.0
  * denormal protection for Preamp*, Amp*
  * Capitalized plugin Names
  * PDF now lists audio in- and outputs as well as control inputs, only
    gives average CPU rating
  * AmpIV: PreampIV + power amp stage
  * Plate2x2: Plate with 2-in, 2-out audio routing
  * Plate damping and bandwidth controls changed to map to filter fc, fixes
    behaviour in hosts that handle the log hint incorrectly

0.1.13
  * AmpIII activate() resets the boost filter

0.1.12
  * PreampIV band controls fixed to operate as expected

0.1.11
  * amps changed back to old tube model :) but new temp & gain behaviour stays
  * SweepVF, AmpIII default value adjustments

0.1.10
  * HRTF recursion runs in doubles
  * Cabinet recursion runs in doubles for much clearer sound
  * all amps fitted with a common tube voltage mapping, dsp/TwelveAX7.h
  * all amps: temperature and gain controls changed slightly
  * all amps declared in one common Amp.h
  * Pan echo fixed to be filtered independent of sample rate
  * Cabinet cosmetics and activate() from port values fix
  * SweepVF fixed to activate() from the current control settings
  * rid all *amp* plugins of the initial hi-pass, not needed anymore
  * PreampIII and AmpIII more authentic with an rbj lo-shelve, +6 dB > 1.2 kHz
    as hinted by circuit analysis
  * something_random() removed, stdlib for random generation

0.1.9
  * Pan plugin
  * 'make depend' instead of 'make dep', uses $(CC) -MM instead of 'makedepend'
  * *Chorus, AmpIII, Plate defaults changed
  * *Chorus optimizations, reintroduces funny zipper noise when 'feedback' is
    non-zero and 't' is changed
  * experimental HRTF plugin
  * Plate 'blend' goes all the way to wet output only
  * dsp/White offers a get_31() method for reduced number of bitshifts needed
  * *Chorus delay line tapping changed to employ cubic interpolation, sounds
    better
  * SweepVF modulation mix algorithm changed to clamp if over-fed, makes
    for wider sweeps
  
0.1.8
  * all oversampling plugins use Kaiser windows instead of Blackman-Harris,
    for much better performance
  * SweepVF modulation range slightly increased
  * Cabinet filter loop cosmetics (slight speedup)
  * new AmpIII Plugin: Preamp plus power amp emulation
  * lowered NOISE_FLOOR (equals 'renormal' number)
  
0.1.7
  * connect ports to lower bound on instantiate()
  * Plate delay line lengths raised, sound changed
  * Eq activate() fixed to initialize from the current settings
  * Preamp* cutoff reverted to 0.1.3 setting, thanks to Ben Saylor for
    testing
  * old IIR-based Preamp cleaned from the sources
  * zipper-noise in *Chorus units for t changes with feedback > 0 eliminated
  * all plugin constructor code moved to init() calls

0.1.6
  * SweepVF modulation mix algorithm changed to maintain proportion, not
    absolute value if x + y + z > 1, for better control
  * create $(DEST) directory on make install, pointed out by Daniel James

0.1.5
  * fixed delay line length miscalculation in ModLattice

0.1.4
  * SweepVF modulation source can be mixed now
  * latency port for VCO*
  * Lorenz and Roessler get x, y, z mixing knobs
  * PreampIV eq bands slightly tuned and coefficients moved into common struct
  * Preamp*, VCO* downsampler filter cutoff lowered
  * Clip downsampler filter cutoff lowered 
  * nonsensical audio output bounds removed
  * simplified VCO* implementation
  * JVRev rewritten for code clarity (funny enough, it also got quicker)
  * fixed JVRev to reset its history on activate()
  * added purpose, copyright and licensing information to all (i think) files.
  * HACKING file
  * CHANGES file
  
0.1.3
  * fixed all compilation problems with gcc 3.3, with the patient help
    of the lad mailing list community
  * dsp/Eq.h SSE assembler code had to go (gcc > 3 doesn't like multi-line 
    asm, and efficiency and even reliability go down if we allow gcc to 
    intersperse its 'optimization' code with our asm)
  
0.1.2
  * fixed more compilation problems with gcc >= 3.0
  
0.1.1
  * tried to (but didn't really) fix compilation problem with ladspa.h
  
0.1.0
  * initial release
	</pre>

	<p id=foot>
		<a name=dat97-1 href=#dat97-1-1>[1]</a>
			J. Dattorro, "Effect Design Part 1: Reverberator and Other Filters", 
			<i>J. Audio Eng. Society</i>, vol. 45, No. 9 (1997 September).<br>
	</p>

		</div>
			&nbsp;<br>

			<div class=foot>
				tim@<a href=http://quitte.de/>quitte.de</a>, January 11 2006.
			</div>		</center>
	</body>
</html>