Debian Codegraph @

modules/lsp-plugins-mb-dyna-processor/src/doc/manuals/plugins/mb_dyna_processor.php

raw
1 <?php
2 plugin_header();
3
4 $sc = (strpos($PAGE, 'sc_') === 0);
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 $sm = ($m == 'ms') ? ' M, S' : (($m != 'm') ? ' L, R' : '');
12 ?>
13
14 <p>
15 This plugin performs multiband dynamic processing of <?= $cc ?> input signal<?php
16 if ($m == 'ms') echo " in Mid-Side mode";
17 elseif ($m == 'lr') echo " by applying individual processing to left and right channels separately";
18 ?>. Flexible sidechain-control configuration <?php
19 if ($sc)
20 echo " and additional sidechain input" . (($m == 'm') ? '' : 's') . " are ";
21 else
22 echo " is";
23 ?>provided.
24 </p>
25 <p>
26 This dynamic processor provides numerous special functions listed below:
27 </p>
28 <ul>
29 <li><b>Modern operating mode</b> - special operating mode that allows to look different at <b>classic</b> crossover-based devices.
30 Crossover-based devices use crossover filters for splitting the original signal into independent frequency bands, then process
31 each band independently by it's individual gate. Finally, all bands become phase-compensated using all-pass filers and then
32 summarized, so the output signal is formed.
33 In <b>Modern</b> mode, each band is processed by pair of dynamic shelving filters. This allows the better control the gain of each band.
34 </li>
35 <li><b>Linear Phase</b> mode allows to split audio signal into multiple frequency bands with linear phase shift.
36 This introduces additional latency but gives several benefits:</li>
37 <ul>
38 <li>Unlike classic crossovers which use IIR (Infinite Impulse Response) filters to split signal into multiple bands and shift the phase
39 of the audio signal at band split points, the <b>Linear Phase</b> allows to use FIR (Finite Impulse Response) filters which are deprived of this.
40 <li>Unlike most IIR filters which are designed using bilinear transform, linear phase filters allow to simulate their transfer function
41 to look like the transfer function of analog filters, without deforming it's magnitude envelope near the nyquist frequency.</li>
42 <li>Unlike design of classic Linkwitz-Riley filters, the design of IIR filters provides shorter transition zone of the filter.</li>
43 </ul>
44 <li><b>Sidechain boost</b> - special mode for assigning the same weight for higher frequencies opposite to lower frequencies.
45 In usual case, the frequency band is processed by gate 'as is'. By the other side, the usual audio signal has 3 db/octave
46 falloff in the frequency domain and could be compared with the pink noise. So the lower frequencies take more
47 effect on gate rather than higher frequencies. <b>Sidechain boost</b> feature allows to compensate the -3 dB/octave falloff
48 of the signal spectrum and, even more, make the signal spectrum growing +3 dB/octave in the almost fully audible frequency range.
49 This is done by specially designed +3 db/oct and +6 db/oct shelving filters.
50 </li>
51 <li><b>Lookahead option</b> - each band of gate can work with some prediction, the lookahead time can be set for each channel independently.
52 To avoid phase distortions, all other bands automatically become delayed for a individually calculated period of time. The overall delay time
53 of the input signal is reported to the host by the plugin as a latency.
54 </li>
55 <li><b>Up to 8 bands</b> are available for use, each band is not attached to it's strict frequency range and can control any frequency range.
56 Also, each band can be controlled by completely different frequency range that can be obtained by applying low-pass and hi-pass filters to the
57 sidechain signal.
58 </li>
59 <?php if ($m == 's') { ?>
60 <li><b>Stereo split mode</b> allows to apply processing to the left and right channels independently.</li>
61 <?php } ?>
62 </ul>
63 <p><b>Controls:</b></p>
64 <ul>
65 <li>
66 <b>Bypass</b> - bypass switch, when turned on (led indicator is shining), the plugin bypasses signal.
67 </li>
68 <li><b>Mode</b> - combo box that allows to switch between the following modes:</li>
69 <ul>
70 <li><b>Classic</b> - classic operating mode using IIR filters and allpass filters to compensate phase shifts.</li>
71 <li><b>Modern</b> - modern operating mode using IIR shelving filters to adjust the gain of each frequency band.</li>
72 <li><b>Linear Phase</b> - linear phase operating mode using FFT transform (FIR filters) to split signal into multiple bands, introduces additional latency.</li>
73 </ul>
74 <li><b>SC Boost</b> - enables addidional boost of the sidechain signal:</li>
75 <ul>
76 <li><b>None</b> - no sidechain boost is applied.</li>
77 <li><b>Pink BT</b> - a +3db/octave sidechain boost using bilinear-transformed shelving filter.</li>
78 <li><b>Pink MT</b> - a +3db/octave sidechain boost using matched-transformed shelving filter.</li>
79 <li><b>Brown BT</b> - a +6db/octave sidechain boost using bilinear-transformed shelving filter.</li>
80 <li><b>Brown MT</b> - a +6db/octave sidechain boost using matched-transformed shelving filter.</li>
81 </ul>
82 <li><b>Link</b> - the name of shared memory link used to receive sidechain signal</li>
83 <li><b>FFT<?= $sm ?> In</b> - enables FFT curve graph of input signal on the spectrum graph.</li>
84 <li><b>FFT<?= $sm ?> Out</b> - enables FFT curve graph of output signal on the spectrum graph.</li>
85 <li><b>Pre-mix</b> - shows pre-mix control overlay.</li>
86 <?php if ($m == 's') { ?>
87 <li><b>Stereo Split</b> - enables independent processing of left and right channels.</li>
88 <?php } elseif ($m == 'lr') { ?>
89 <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>
90 <?php } elseif ($m == 'ms') { ?>
91 <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>
92 <?php } ?>
93 <li><b>Filters<?= $sm ?></b> - enables drawing transfer function of each sidechain filter on the spectrum graph.</li>
94 <li><b>Zoom</b> - zoom fader, allows to adjust zoom on the frequency chart.</li>
95 </ul>
96 <p><b>'Signal' section:</b></p>
97 <ul>
98 <li><b>Input</b> - the amount of gain applied to the input signal before processing.</li>
99 <li><b>Output</b> - the amount of gain applied to the output signal before processing.</li>
100 <li><b>Dry</b> - the amount of dry (unprocessed) signal passed to the output.</li>
101 <li><b>Wet</b> - the amount of wet (processed) signal passed to the output.</li>
102 <li><b>Dry/Wet</b> - the knob that controls the balance between the mixed dry and wet signal (see <b>Dry</b> and <b>Wet</b>) and the dry (unprocessed) signal.</li>
103 <li><b>In</b> - the input signal meter.</li>
104 <li><b>Out</b> - the output signal meter.</li>
105 </ul>
106 <p><b>'Analysis' section:</b></p>
107 <ul>
108 <li><b>Reactivity</b> - the reactivity (smoothness) of the spectral analysis.</li>
109 <li><b>Shift</b> - allows to adjust the overall gain of the analysis.</li>
110 </ul>
111 <?php if ($m == 'lr') {?>
112 <p><b>'Split Left' and 'Split Right' sections</b> - allow to quickly control all bands and provides most frequently
113 used controls for Left and Right channels of stereo signal independently:</p>
114 <?php } elseif ($m == 'ms') {?>
115 <p><b>'Split Mid' and 'Split Side' sections</b> - allow to quickly control all bands and provides most frequently
116 used controls for Middle and Side parts of stereo signal independently:</p>
117 <?php } else {?>
118 <p><b>'Split' section</b> - allows to quickly control all bands and provides most frequently used controls:</p>
119 <?php }?>
120 <ul>
121 <li><b>Band</b> - allows to enable the corresponding band, band #0 is <b>always</b> enabled.</li>
122 <li><b>Range</b> - allows to adjust the start frequency of the frequency range controlled by the band.</li>
123 <li><b>Controls</b> - set of buttons that control the behaviour of the compressor:</li>
124 <ul>
125 <li><b>On</b> - enables compressor assigned to the corresponding frequency band.</li>
126 <li><b>S</b> - turns on soloing mode to the selected band by applying -36 dB gain to non-soloing bands</li>
127 <li><b>M</b> - turns on muting mode to the selected band by applying -36 dB gain to it</li>
128 <li><b>Sidechain combo</b> - allows to select external sidechain inputs or shared memory audio stream</li>
129 </ul>
130 <li><b>SC Preamp</b> - applies additional gain to the sidechain band.</li>
131 <li><b>Makeup</b> - applies additional gain to the output of the corresponding dynamic processor.</li>
132 <li><b>Attack Time</b> - attack time of the compressor.</li>
133 <li><b>Release Time</b> - release time of the compressor.</li>
134 <li><b>Ratio Low</b> - the compression/expansion ratio of the curve at the low level of signal.</li>
135 <li><b>Ratio High</b> - the compression/expansion ratio of the curve at the high level of signal.</li>
136 <li><b>Threshold</b> - the settings for each of four available thresholds for the corresponding dynamic processor.</li>
137 </ul>
138 <?php if ($m == 'lr') {?>
139 <p><b>'Band N' section</b> - allows to simultaneously control all parameters of dynamic processor of Left and Right
140 channels assigned to the selected frequency band:</p>
141 <?php } elseif ($m == 'ms') {?>
142 <p><b>'Band N' section</b> - allows to simultaneously control all parameters of dynamic processor of Middle and Side
143 channels assigned to the selected frequency band:</p>
144 <?php } else {?>
145 <p><b>'Band N' section</b> - allows to control all parameters for the selected frequency band:</p>
146 <?php }?>
147 <ul>
148 <li><b>Sidechain Source</b> - allows to set the sidechain source</li>
149 <ul>
150 <li><b>Internal</b> - the audio inputs of plugin are used as sidechain signal.</li>
151 <?php if ($sc) { ?>
152 <li><b>External</b> - additional sidechain audio inputs of plugins are used as sidechain signal.</li>
153 <?php } ?>
154 <li><b>Link</b> - the shared memory link is used to receive sidechain signal.</li>
155 </ul>
156 <li><b>Sidechain Mode</b> - combo box that allows to control sidechain working mode:</li>
157 <ul>
158 <li><b>Peak</b> - peak mode.</li>
159 <li><b>RMS</b> - Root Mean Square (SMA) of the input signal.</li>
160 <li><b>LPF</b> - input signal processed by recursive 1-pole Low-Pass Filter (LPF).</li>
161 <li><b>SMA</b> - input signal processed by Simple Moving Average (SMA) filter.</li>
162 <?php if ($m != 'm') { ?>
163 <li><b>Middle</b> - middle part of signal is used for sidechain processing.</li>
164 <li><b>Side</b> - side part of signal is used for sidechain processing.</li>
165 <li><b>Left</b> - only left channel is used for sidechain processing.</li>
166 <li><b>Right</b> - only right channel is used for sidechain processing.</li>
167 <li><b>Min</b> - the absolute minimum value is taken from stereo input.</li>
168 <li><b>Max</b> - the absolute maximum value is taken from stereo input.</li>
169 <?php } ?>
170 <?php if ($m == 's') { ?>
171 <li><b>Left/Right</b> - left and right channels are being processing using respectively the left and right sidechain channels in stereo split mode.</li>
172 <li><b>Right/Left</b> - left and right channels are being processing using respectively the right and left sidechain channels in stereo split mode.</li>
173 <li><b>Mid/Side</b> - left and right channels are being processing using respectively the middle and side parts of sidechain signal in stereo split mode.</li>
174 <li><b>Side/Mid</b> - left and right channels are being processing using respectively the side and middle parts of sidechain signal in stereo split mode.</li>
175 <?php } ?>
176 </ul>
177 <li><b>Sidechain Lookahead</b> - look-ahead time of the sidechain relative to the input signal.</li>
178 <li><b>Sidechain Preamp</b> - pre-amplification of the sidechain signal.</li>
179 <li><b>Sidechain Reactivity</b> - reactivity of the sidechain signal.</li>
180 <li><b>Sidechain LCF</b> - button turns on the low-cut filter for the sidechain signal and knob allows to control the frequency of the filter.</li>
181 <li><b>Sidechain HCF</b> - button turns on the high-cut filter for the sidechain signal and knob allows to control the frequency of the filter.</li>
182
183 <?php if ($m == 'lr') {?>
184 <li><b>Dynamic Processor Left/Right On</b> - enables corresponding dynamic processor assigned to the corresponding frequency band.</li>
185 <li><b>Dynamic Processor Left/Right Solo</b> - turns on soloing mode to the selected band by applying -36 dB gain to non-soloing bands.</li>
186 <li><b>Dynamic Processor Left/Right Mute</b> - turns on muting mode to the selected band by applying -36 dB gain to it.</li>
187 <?php } elseif ($m == 'ms') {?>
188 <li><b>Dynamic Processor Mid/Side On</b> - enables corresponding dynamic processor assigned to the corresponding frequency band.</li>
189 <li><b>Dynamic Processor Mid/Side Solo</b> - turns on soloing mode to the selected band by applying -36 dB gain to non-soloing bands.</li>
190 <li><b>Dynamic Processor Mid/Side Mute</b> - turns on muting mode to the selected band by applying -36 dB gain to it.</li>
191 <?php } else {?>
192 <li><b>Dynamic Processor On</b> - enables dynamic processor assigned to the corresponding frequency band.</li>
193 <li><b>Dynamic Processor Solo</b> - turns on soloing mode to the selected band by applying -36 dB gain to non-soloing bands.</li>
194 <li><b>Dynamic Processor Mute</b> - turns on muting mode to the selected band by applying -36 dB gain to it.</li>
195 <?php }?>
196 <?php if ($m == 'lr') {?>
197 <li><b>Dynamic Processor Left</b> - additionally draws the sharpened curve model for the left channel.</li>
198 <li><b>Dynamic Processor Right</b> - additionally draws the sharpened curve model for the right channel.</li>
199 <?php } elseif ($m == 'ms') {?>
200 <li><b>Dynamic Processor Mid</b> - additionally draws the sharpened curve model for the middle channel.</li>
201 <li><b>Dynamic Processor Side</b> - additionally draws the sharpened curve model for the side channel.</li>
202 <?php } else {?>
203 <li><b>Dynamic Processor Model</b> - additionally draws the sharpened curve model</li>
204 <?php }?>
205 <li><b>Dynamic Processor Ratio Low</b> - the compression/expansion ratio of the curve at the low level of signal.</li>
206 <li><b>Dynamic Processor Ratio High</b> - the compression/expansion ratio of the curve at the high level of signal.</li>
207 <li><b>Dynamic Processor Makeup</b> - additional amplification gain after processing stage.</li>
208 <li><b>Dynamic Processor Attack</b> - default attack time of the dynamic processor.</li>
209 <li><b>Dynamic Processor Release</b> - default release time of the dynamic processor.</li>
210 <li><b>Dynamic Processor Hold</b> - the time period the envelope holds it's maximum value before starting the release.</li>
211 <li><b>Dynamic Processor Gain</b> - the amount of gain applied to frequency band by the compression curve.</li>
212 <li><b>Dynamic Processor Ranges</b> - allows to configure up to four additional knees, attack and release ranges:</li>
213 <ul>
214 <li><b>Thr</b> - Knob that enables additional knee.</li>
215 <li><b>Att</b> - Knob that enables additional attack range.</li>
216 <li><b>Rel</b> - Knob that enables additional release range.</li>
217 <li><b>Thresh</b> - Threshold of the additional knee, works only if corresponding <b>Thr</b> button is turned on.</li>
218 <li><b>Gain</b> - Gain of the additional knee, works only if corresponding <b>Thr</b> button is turned on.</li>
219 <li><b>Knee</b> - Softness of the knee, works only if corresponding <b>Thr</b> button is turned on.</li>
220 <li><b>Attack</b> - Pair of knobs that allows to adjust the attack threshold and attack time of the additional
221 attack range. The new attack time is applied if the envelope is <b>over</b> the specified threshold. Otherwise
222 the attack time of previous range or default attack time (if there is no previous range) will be applied.
223 </li>
224 <li><b>Release</b> - Pair of knobs that allows to adjust the release threshold and release time of the additional
225 release range. The new release time is applied if the envelope is <b>over</b> the specified threshold. Otherwise
226 the release time of previous range or default release time (if there is no previous range) will be applied.
227 </li>
228 </ul>
229 </ul>
230
231 <p><b>Pre-mix control overlay:</b></p>
232 <ul>
233 <?php if ($sc) { ?>
234 <li><b>In -> SC</b> - the amount of signal from input channel added to the Sidechain.</li>
235 <?php } ?>
236 <li><b>In -> Link</b> - the amount of signal from input channel added to the shared memory link.</li>
237 <?php if ($sc) { ?>
238 <li><b>SC -> In</b> - the amount of signal from sidechain input channel added to the input channel.</li>
239 <li><b>SC -> Link</b> - the amount of signal from sidechain input channel added to the shared memory link.</li>
240 <?php } ?>
241 <li><b>Link -> In</b> - the amount of signal from shared memory link added to the input channel.</li>
242 <li><b>Link -> SC</b> - the amount of signal from shared memory link added to the sidechain channel.</li>
243 </ul>
244