[SCM] calf/master: Deesser, Pulsator

[js at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 29b4dab776278e2878d2d785a0984cb2ffb5dcc7
Author: Markus Schmidt <schmidt at boomshop.net>
Date:   Mon Nov 16 09:41:25 2009 +0100

    Deesser, Pulsator

diff --git a/doc/manuals/Deesser b/doc/manuals/Deesser
new file mode 100644
index 0000000..c2d7063
--- /dev/null
+++ b/doc/manuals/Deesser
@@ -0,0 +1,31 @@
+Deesser
+
+Functionality
+
+A Deesser is used to dynamically reduce high frequencies. The standard field of use is the reduction of "sssss" and "shhhh" in vocal tracks, that's where it's name came from. A deesser is mainly based on a compressor that reacts not on the full range signal but on a filtered sidechain signal. The signal is split in two different threads. The sidechain thread is sent through a filter, before it acts as a level for reducing the gain of the main thread. A deesser could also be used to reduce some high transients of a snaredrum or to bring some "air" in a sound without killing your tweeter on attack. So it may act as a creative effect just like as a troubleshooter. But never compress a vocal track without adding a deesser afterwards - if you have a heart for your listeners.
+
+Calf Deesser is able to be driven in sidechain mode. It means that not the full range signal will be affected by the gain reduction but only frequencies above the split frequency are manipulated in gain. Normally a wideband deesser sounds much cleaner on a single vocal track. But multitimbral vocals recordings could benefit a lot from this functionality. It also gives a great advantage for processing instrument tracks like strings for example. If you haven't understand it by now, think of a sidechain deesser like of a dynamically processing highshelf equalizer.
+
+A neat special in the sidechain is the additional peak. Normally "sssss" and "shhhh" are dynamically far apart. With this bell filter you can accentuate or reduce significant frequencies to get the most precise control over your highs before they will reduce your main signal. The peak affects the sidechain signal but isn't added to the main signal's high band in split mode.
+
+Main information about dynamic processing is located in the compressor section. Additional information about sidechaining can be found in the sidechain compressor's section.
+
+Controls
+
+Bypass: Don't process anything, just bypass the signal
+Detected: This meter shows the level of the (filtered) signal which is used for detection
+Gain Reduction: the level of reduction on the original signal
+0dB: Flashes, if the signal rises about 0dB in the output stage
+Active: Flashes, if the deesser detects a noticeable signal
+S/C listen: Sends the sidechain (filtered) signal to the output for acoustical control
+Detection: Choose if the deesser should take the exact signal for detection or an RMS like one (it's mainly smoother)
+Mode: Select your operation mode between wideband or split
+Threshold: If a signal rises above this level it will affect the gain reduction
+Ratio: Set a ratio about which the signal is reduced. 1:2 means that if the level rises 4dB above the threshold, it will be only 2dB above after the reduction.
+Laxity: The reaction of the deesser. Higher values won't affect really short peaks.
+Makeup: Amplify your signal after processing. In split mode only the high band will be made up.
+Split: The split frequency. All signals above this frequency will affect the gain reduction (and are affected in split mode, too)
+Gain: It shifts the volume of the higher band. In wideband mode it affects the sidechain, in split mode it also affects the processed high frequencies.
+Peak: Make a more precise selection of the sidechain signal with this bell
+Level: Increase or decrease the chosen frequency
+Peak Q: Set the quality of the bell. Higher values will affect a narrower, higher ones a wider band
diff --git a/doc/manuals/Pulsator b/doc/manuals/Pulsator
new file mode 100644
index 0000000..c24364c
--- /dev/null
+++ b/doc/manuals/Pulsator
@@ -0,0 +1,30 @@
+Pulsator
+
+Functionality
+
+Calf Pulsator is something between an autopanner and a tremolo. But it can produce funny stereo effects as well. Pulsator changes the volume of left and right channel based on a LFO (low frequency oscillator) with different waveforms and shifted phases.
+
+The kicker of Pulsator is the ability to define an offset between left and right channel. An offset of 0% means that both LFO shapes match each other. Left and right channel are altered equally - a conventional tremolo. An offset of 50% means that the shape of the right channel is exactly shifted in phase (or moved backwards about half of the frequency) - Pulsator acts as an autopanner. At 100% both curves match again. Every setting inbetween moves the phaseshift gapless between all stages and produces some "bypassing" sounds with sine and triangle waveform. The more you push the fader to the right (starting from the middle) the faster the signal passes from left to right speaker.
+
+A mono switch forces Pulsator to use autopanner input stage, where both left and right channels are merged and redistributed to the amplifier stage again. Otherwise it has to be called "autobalancer" since a panoramic fader needs a mono signal at input. Leaving "Mono-in" switch untouched doesn't affect the input signal at all.
+
+Strange effects can be achieved with square or saw waveforms. Try it with a setting matching your bpm on a crushed drum track or on a synth pad with delay. You will get your frequency if you divide your bpm by 60. So 120 bpm will result in 2Hz which matches the quarters. If it should wobble on the eighths, halve the frequency. If you want a triplet feeling, divide the quarter freqency by 4 and multiply it with 3 afterwards.
+
+If you want to fix Pulsator on a beat you can automate the "Reset" switch in your sequencer to restart the LFO on every bar for example.
+
+Controls
+
+Input: Control the input level before the signal is processed. In this effect it can be useful if you feed Pulsator with a true mono signal only on the left channel. If you toggle "Mono-in" switch active, the signal is decreased by 6dB due to merging. Add those 6dB with input knob again.
+In L/In R: The level after the input knob
+0dB: Flashes if input level rises above 0dB
+Bypass: Don't process anything, just bypass the signal
+Mono-in: Merge left and right channel to mono and split again (for using Pulsator as true autopanner)
+Out L/Out R: The level after processing and after the output knob
+0dB: Flashes if output level rises above 0dB
+Output: Control the output of the effect - clipping could destroy your signal
+Frequency: The speed of the LFO in Hz (1Hz means one wavelength in a second)
+Offset L/R: Delay the right channel in comparison with the left one to shift the phase between them
+Mode: Select a waveform the LFO will use
+Modulation: Define how much your original signal is affected by the LFO
+Reset: Restart the LFO
+

-- 
calf audio plugins packaging