| 1 |
<?php |
| 2 |
plugin_header(); |
| 3 |
|
| 4 |
$nf = (strpos($PAGE, '_x32') > 0) ? 32 : 16; |
| 5 |
$m = (strpos($PAGE, '_mono') > 0) ? 'm' : ( |
| 6 |
(strpos($PAGE, '_stereo') > 0) ? 's' : ( |
| 7 |
(strpos($PAGE, '_lr') > 0) ? 'lr' : ( |
| 8 |
(strpos($PAGE, '_ms') > 0) ? 'ms' : '?' |
| 9 |
))); |
| 10 |
$cc = ($m == 'm') ? 'mono' : 'stereo'; |
| 11 |
?> |
| 12 |
<?php require_once("${DOC_BASE}/manuals/common/filters.php"); ?> |
| 13 |
<p> |
| 14 |
There are some recommendations that could be given when applying equalization: |
| 15 |
</p> |
| 16 |
<ul> |
| 17 |
<li><b>Resonance filter</b> with high Quality Factor can be good choice to cut annoying masking resonances from the original sound.</li> |
| 18 |
<li><b>Bell filter</b> with medium Quality Factor can be used when there is necessity to remove short range of frequencies.</li> |
| 19 |
<li><b>Bell filter</b> with low Quality Factor can be used to raise or lower wide range of frequencies.</li> |
| 20 |
<li><b>Shelving filters</b> with low Quality Factor also can be used to lower or raise the large diapasone of frequencies.</li> |
| 21 |
<li><b>Low-pass</b> and <b>High-pass filters</b> can be used with a bit raised Quality Factor to flatten frequency fall. Usage of |
| 22 |
Butterworth-Chebyshev low-pass and high-pass filters with 2x and 3x slope can give good results when cutting unwanterd low and high |
| 23 |
frequencies from voice or guitar sound. |
| 24 |
</li> |
| 25 |
<li><b>Matched Z Transform (MT) filters</b> are probably the best choice when cutting out individual short range of frequencies.</li> |
| 26 |
<li><b>Bilinear Transform (BT) filters</b> are good when cutting-out high frequencies because they have -INF dB amplification at the Nyquist frequency.</li> |
| 27 |
<li><b>Direct Design (DR) filters</b> add alternative implementations for the various supperted filter types, and may be chosen whenever their frequency response is best suited.</li> |
| 28 |
</ul> |
| 29 |
<p> |
| 30 |
This plugin performs parametric equalization of <?= $cc ?> channel<?php |
| 31 |
if ($m == 'ms') echo " in Mid-Side mode"; |
| 32 |
elseif ($m == 'lr') echo " by applying individual equalization to left and right channels separately"; |
| 33 |
?>. Up to <?= $nf ?> filters are available for signal processing simultaneously. |
| 34 |
</p> |
| 35 |
<p> |
| 36 |
Additional filter inspection feature with the controlled width of the bandpass filter allows to listen the frequency |
| 37 |
band around several filter types to make search and cut off resonances much easier: |
| 38 |
</p> |
| 39 |
<? if (($m == 'ms') || ($m == 'lr')) { ?> |
| 40 |
<p> |
| 41 |
It is also possible to switch filter between <? if ($m == 'ms') echo "Mid and Side"; else "Left and Right"; ?> channels |
| 42 |
by selecting corresponding menu item in the popup menu ( |
| 43 |
<? if ($m == 'ms') echo "Switch to Mid / Switch to Side"; |
| 44 |
else "Switch to Left / Switch to Right"; ?> |
| 45 |
) above the filter's dot on the graph. |
| 46 |
</p> |
| 47 |
<? } ?> |
| 48 |
|
| 49 |
<p>The steepness of the filter is depending on the type of the filter selected, it's slope and Q factor.<p> |
| 50 |
<p>There is a simple rule that allows to compute the steepness of IIR (recursive) low-pass or high-pass filter which consists |
| 51 |
of so-called poles and zeros:<p> |
| 52 |
<ul> |
| 53 |
<li>each pole gives -6 dB/octave magnitude attenuation above the pole's frequency;</li> |
| 54 |
<li>each zero gives +6 dB/octave magnitude amplification above the zero's frequency.</li> |
| 55 |
</ul> |
| 56 |
<p>That allows to make the following conclusions:</p> |
| 57 |
<ul> |
| 58 |
<li>the more poles are used by the filter, the more steep magnitude attenuation will be;</li> |
| 59 |
<li>when talking about the magnitude, each zero cancels the pole's attenuation curve and vice verse, depending on their locations in the frequency domain;</li> |
| 60 |
<li>the filter can not contain more zeros than the number of poles. Otherwise it will give infinite magnitude at the infinite frequency;</li> |
| 61 |
<li>the slope of simple filers is a discrete value with step of -6 dB/octave.</li> |
| 62 |
</ul> |
| 63 |
<p>There is a table that specifies characteristics of lowpass filters depending on the selected filter mode and slope.</p> |
| 64 |
<table> |
| 65 |
<tr> |
| 66 |
<th rowspan="2">Mode</th> |
| 67 |
<th colspan="4">Poles</th> |
| 68 |
<th colspan="4">Slope (dB/oct)</th> |
| 69 |
</tr> |
| 70 |
<tr> |
| 71 |
<th>x1</th> |
| 72 |
<th>x2</th> |
| 73 |
<th>x3</th> |
| 74 |
<th>x4</th> |
| 75 |
<th>x1</th> |
| 76 |
<th>x2</th> |
| 77 |
<th>x3</th> |
| 78 |
<th>x4</th> |
| 79 |
</tr> |
| 80 |
<tr> |
| 81 |
<td>RLC</td> |
| 82 |
<td>2</td> |
| 83 |
<td>4</td> |
| 84 |
<td>6</td> |
| 85 |
<td>8</td> |
| 86 |
<td>-12</td> |
| 87 |
<td>-24</td> |
| 88 |
<td>-36</td> |
| 89 |
<td>-48</td> |
| 90 |
</tr> |
| 91 |
<tr> |
| 92 |
<td>BWC</td> |
| 93 |
<td>2</td> |
| 94 |
<td>4</td> |
| 95 |
<td>6</td> |
| 96 |
<td>8</td> |
| 97 |
<td>-12</td> |
| 98 |
<td>-24</td> |
| 99 |
<td>-36</td> |
| 100 |
<td>-48</td> |
| 101 |
</tr> |
| 102 |
<tr> |
| 103 |
<td>LRX</td> |
| 104 |
<td>4</td> |
| 105 |
<td>8</td> |
| 106 |
<td>12</td> |
| 107 |
<td>16</td> |
| 108 |
<td>-24</td> |
| 109 |
<td>-48</td> |
| 110 |
<td>-72</td> |
| 111 |
<td>-96</td> |
| 112 |
</tr> |
| 113 |
<tr> |
| 114 |
<td>APO</td> |
| 115 |
<td>2</td> |
| 116 |
<td>2</td> |
| 117 |
<td>2</td> |
| 118 |
<td>2</td> |
| 119 |
<td>-12</td> |
| 120 |
<td>-12</td> |
| 121 |
<td>-12</td> |
| 122 |
<td>-12</td> |
| 123 |
</tr> |
| 124 |
</table> |
| 125 |
|
| 126 |
<p>Adjusting q can give additional steepness to the curve but making it too high gives extra non-linearity of the magnitude in the passed spectrum.</p> |
| 127 |
|
| 128 |
<ul> |
| 129 |
<li>Bell-shaped filters;</li> |
| 130 |
<li>Notch filters;</li> |
| 131 |
<li>Resonance filters;</li> |
| 132 |
<li>Hi-shelving filters;</li> |
| 133 |
<li>Lo-shelving filters.</li> |
| 134 |
</ul> |
| 135 |
<p> |
| 136 |
The frequency control feature allows to detect the note and the note detune the filter is operating with at the top |
| 137 |
of the graph area. |
| 138 |
</p> |
| 139 |
<p>This plugin also allows to apply decramping technique to the audible spectrum which allows to make bilinear transformed filters |
| 140 |
behave more like analog ones. The decramping parameter allows to select the desired processing sample rate by applying the multiplier |
| 141 |
to the frequency of 44100 Hz. If the desired sample rate is less than the actual sample rate, no oversampling is applied. If the desired |
| 142 |
sample rate is greater than the actual sample rate, the proper oversampling coefficient is computed and applied to the signal.</p> |
| 143 |
<p> |
| 144 |
Additionally, mouse double-click on the graph area allows to add a filter with desired frequency and gain |
| 145 |
settings depending on the actual frequency value at the position of the mouse click: |
| 146 |
</p> |
| 147 |
<ul> |
| 148 |
<li>20 Hz and below: Hi-pass RLC BT filter with Q=0.5;</li> |
| 149 |
<li>20 Hz - 50 Hz: Lo-shelf RLC BT filter with Q=0.5;</li> |
| 150 |
<li>50 Hz - 5 kHz: Bell RLC BT filter with Q=2;</li> |
| 151 |
<li>5 kHz - 15 kHz: Hi-shelf RLC BT filter with Q=0.5;</li> |
| 152 |
<li>15 kHz and above: Lo-pass RLC BT filter with Q=0.5.</li> |
| 153 |
</ul> |
| 154 |
<p> |
| 155 |
Several filter parameters like type, mode, slope, inspection, solo and mute are also available for change from the |
| 156 |
context menu which can be displayed by the right mouse click over the filter's control dot in the graph area. |
| 157 |
</p> |
| 158 |
<p><b>Meters:</b></p> |
| 159 |
<ul> |
| 160 |
<?php if ($m == 'lr') { ?> |
| 161 |
<li><b>L/R Link</b> - enables linking between Left and Right channel controls so change of one forces the sibling to become the same value.</li> |
| 162 |
<li><b>Input</b> - the level meter for left and right channels of the input signal.</li> |
| 163 |
<li><b>Output</b> - the level meter for left and right channels of the output signal.</li> |
| 164 |
<?php } elseif ($m == 'ms') { ?> |
| 165 |
<li><b>M/S Link</b> - enables linking between Mid and Side channel controls so change of one forces the sibling to become the same value.</li> |
| 166 |
<li><b>Input</b> - the level meter for left and right channels of the input signal. |
| 167 |
If <b>Listen</b> button is pressed, it shows the level of middle and side channels of the input signal respectively.</li> |
| 168 |
<li><b>Output</b> - the level meter for left and right channels of the output signal. |
| 169 |
If <b>Listen</b> button is pressed, it shows the level of middle and side channels of the output signal respectively.</li> |
| 170 |
<?php } elseif ($m != 'm') { ?> |
| 171 |
<li><b>Input</b> - the level meter for left and right channels of the input signal.</li> |
| 172 |
<li><b>Output</b> - the level meter for left and right channels of the output signal.</li> |
| 173 |
<?php } else { ?> |
| 174 |
<li><b>Input</b> - the level meter of the input mono signal.</li> |
| 175 |
<li><b>Output</b> - the level meter of the output mono signal.</li> |
| 176 |
<?php } ?> |
| 177 |
</ul> |
| 178 |
<p><b>Controls:</b></p> |
| 179 |
<ul> |
| 180 |
<li> |
| 181 |
<b>Bypass</b> - bypass switch, when turned on (led indicator is shining), the plugin bypasses signal. |
| 182 |
</li> |
| 183 |
<li><b>Mode</b> - equalizer working mode, enables the following mode for all filters:</li> |
| 184 |
<ul> |
| 185 |
<li><b>IIR</b> - Infinite Impulse Response filters, nonlinear minimal phase. In most cases does not add noticeable latency to output signal.</li> |
| 186 |
<li><b>FIR</b> - Finite Impulse Response filters with linear phase, finite approximation of equalizer's impulse response. Adds noticeable latency to output signal.</li> |
| 187 |
<li><b>FFT</b> - Fast Fourier Transform approximation of the frequency chart, linear phase. Adds noticeable latency to output signal.</li> |
| 188 |
<li><b>SPM</b> - Spectral Processor Mode of equalizer, equalizer transforms the magnitude of signal spectrum instead of applying impulse response to the signal.</li> |
| 189 |
</ul> |
| 190 |
<li><b>Decramp</b> - Enables decramping of filter transfer functions inside of the audible frequency range by applying oversampling.</li> |
| 191 |
<?php if ($m == 'ms') { ?> |
| 192 |
<li><b>Mid</b> - button enables the frequency chart and FFT analysis for the middle channel, knob allows to adjust the level of the middle channel.</li> |
| 193 |
<li><b>Side</b> - button enables the frequency chart and FFT analysis for the side channel, knob allows to adjust the level of the side channel.</li> |
| 194 |
<li><b>Listen</b> - allows to listen middle channel and side channel. Passes middle channel to the left output channel, side channel to the right output channel.</li> |
| 195 |
<?php } elseif ($m != 'm') { ?> |
| 196 |
<li><b>Left</b> - enables the <?php if ($m != 's') echo "frequency chart and "; ?>FFT analysis for the left channel.</li> |
| 197 |
<li><b>Right</b> - enables the <?php if ($m != 's') echo "frequency chart and "; ?>FFT analysis for the right channel.</li> |
| 198 |
<?php } ?> |
| 199 |
<li><b>Zoom</b> - zoom fader, allows to adjust zoom on the frequency chart.</li> |
| 200 |
<li><b>Inspect</b> - the button that disables the inspect mode for currently selected filter.</li> |
| 201 |
<li><b>Auto</b> - the button that enables automatic filter inspection for the currently edited filter.</li> |
| 202 |
<li><b>Inspect knob</b> - the knob that controls the bandwidth of the bandpass filter around the inspected filter.</li> |
| 203 |
</ul> |
| 204 |
<p><b>'Signal' section:</b></p> |
| 205 |
<ul> |
| 206 |
<li><b>Input</b> - input signal amplification.</li> |
| 207 |
<li><b>Output</b> - output signal amplification.</li> |
| 208 |
<?php if ($m != 'm') { ?> |
| 209 |
<li><b>Balance</b> - balance between left and right output channels.</li> |
| 210 |
<?php } ?> |
| 211 |
<?php if ($m == 'ms') { ?> |
| 212 |
<li><b>Pitch Mid</b> - the frequency shift for all filters of the middle channel, in semitones.</li> |
| 213 |
<li><b>Pitch Side</b> - the frequency shift for all filters of the side channel, in semitones.</li> |
| 214 |
<?php } elseif ($m == 'lr' ) { ?> |
| 215 |
<li><b>Pitch Left</b> - the frequency shift for all filters of the left channel, in semitones.</li> |
| 216 |
<li><b>Pitch Right</b> - the frequency shift for all filters of the right channel, in semitones.</li> |
| 217 |
<?php } else { ?> |
| 218 |
<li><b>Pitch</b> - the frequency shift for all filters, in semitones.</li> |
| 219 |
<?php }?> |
| 220 |
</ul> |
| 221 |
<p><b>'Analysis' section:</b></p> |
| 222 |
<ul> |
| 223 |
<li><b>FFT</b> - enables FFT analysis before or after processing.</li> |
| 224 |
<li><b>Reactivity</b> - the reactivity (smoothness) of the spectral analysis.</li> |
| 225 |
<li><b>Shift</b> - allows to adjust the overall gain of the analysis.</li> |
| 226 |
</ul> |
| 227 |
<p><b>'Filters' section:</b></p> |
| 228 |
<ul> |
| 229 |
<li><b>Filter</b> - sets up the mode of the selected filter. Currently available filters:</li> |
| 230 |
<ul> |
| 231 |
<li><b>Off</b> - Filter is not working (turned off).</li> |
| 232 |
<li><b>Bell</b> - Bell filter with smooth peak/recess.</li> |
| 233 |
<li><b>Hi-pass</b> - High-pass filter with rejection of low frequencies.</li> |
| 234 |
<li><b>Hi-shelf</b> - Shelving filter with adjustment of high frequency range.</li> |
| 235 |
<li><b>Lo-pass</b> - Low-pass filter with rejection of high frequencies.</li> |
| 236 |
<li><b>Lo-shelf</b> - Shelving filter with adjustment of low frequencies.</li> |
| 237 |
<li><b>Notch</b> - Notch filter with full rejection of selected frequency.</li> |
| 238 |
<li><b>Resonance</b> - Resonance filter with sharp peak/recess.</li> |
| 239 |
<li><b>Allpass</b> - All-pass filter which only affects the phase of the audio signal at the specified frequency.</li> |
| 240 |
</ul> |
| 241 |
<li><b>Mode</b> - sets up the class of the filter:</li> |
| 242 |
<ul> |
| 243 |
<li><b>RLC</b> - Very smooth filters based on similar cascades of RLC contours.</li> |
| 244 |
<li><b>BWC</b> - Butterworth-Chebyshev-type-1 based filters. Does not affect <b>Resonance</b> and <b>Notch</b> filters.</li> |
| 245 |
<li><b>LRX</b> - Linkwitz-Riley based filters. Does not affect <b>Resonance</b> and <b>Notch</b> filters.</li> |
| 246 |
<li><b>APO</b> - Digital biquad filters derived from canonic analog biquad prototypes digitalized through |
| 247 |
Bilinear transform. These are <a href="https://shepazu.github.io/Audio-EQ-Cookbook/audio-eq-cookbook.html">textbook filters</a> |
| 248 |
which are implemented as in the <a href="https://equalizerapo.com/">EqualizerAPO</a> software.</li> |
| 249 |
<li><b>BT</b> - Bilinear Z-transform is used for pole/zero mapping.</li> |
| 250 |
<li><b>MT</b> - Matched Z-transform is used for pole/zero mapping.</li> |
| 251 |
<li><b>DR</b> - Direct design is used to serve the digital filter coefficients directly in the digital domain, without performing transforms.</li> |
| 252 |
</ul> |
| 253 |
<li><b>Slope</b> - the slope of the filter characteristics.</li> |
| 254 |
<li><b>I</b> - the inspection button, allows to inspect selected filter.</li> |
| 255 |
<li><b>S</b> - the soloing button, allows to solo selected filters.</li> |
| 256 |
<li><b>M</b> - the mute button, allows to mute selected filters.</li> |
| 257 |
<li><b>Freq</b> - the cutoff/resonance frequency of the filter.</li> |
| 258 |
<li><b>Gain</b> - the gain of the filter, disabled for lo-pass/hi-pass/notch filters.</li> |
| 259 |
<li><b>Q</b> - the quality factor of the filter.</li> |
| 260 |
<li><b>Hue</b> - the color of the frequency chart of the filter on the graph.</li> |
| 261 |
</ul> |