Voxengo Primary User Guide en
Voxengo Primary User Guide en
Voxengo Primary User Guide en
https://www.voxengo.com/
Contents
Introduction 5
Common Features of Voxengo Audio Plug-Ins 5
User Interface Layout 6
Title Bar 6
Control Buttons 6
Plug-In Control Interface 6
Hint Line 6
Main Control Buttons 7
Plug-In Instance Name Edit Box 7
Oversampling Selector 7
Bypass Switch 8
A/B Switch Button 8
“A > B” (“B > A”) Button 8
Sat Switch 8
Standard Controls 9
Knob 9
Keyboard Value Entry 10
Value List Selector 10
Slider 10
Level Meter 10
Equalizer 11
Equalizer – Group Editing 12
Equalizer – Spectrum 13
Equalizer – Narrow-Band Sweeping 13
Envelope Editor 14
Quick Zoom-In 14
Scroller 14
Window Resizer 15
Spectrum Mode Editor 15
DC Filter Mode Editor 17
2
Voxengo Primary User Guide
3
Voxengo Primary User Guide
4
Voxengo Primary User Guide
Introduction
Voxengo audio plug-ins feature a set of standard interface elements that are shared
among all Voxengo plug-ins.
This guide describes functionality of these elements, focusing on the interaction
between the user and the plug-in. This means that this guide does not describe an
actual application of user interface elements (some may control Gain, some may
control Frequency, etc.), but shows the ways of using these elements efficiently from
the user perspective. After reading this guide you will be able to use common
features of all Voxengo audio plug-ins. Any non-standard or special features are
described in the guides for the plug-ins that contain these non-standard or special
features, and are not covered by this guide.
Beside user interface description this guide contains important technical information
about Voxengo plug-ins.
Preset manager
A/B comparison switch
Internal channel routing
Mid/side processing
Undo/redo history
Input channel naming
Channel grouping
Channel group naming
Settings (coloration, scale, hints)
Global settings (control precision, etc.)
Plug-in instance naming
Oversampling
Bypass switch
External side-chain (where applicable)
Contextual hint messages
5
Voxengo Primary User Guide
The graphical interface of every Voxengo plug-in consists of four distinctive parts: the
title bar, the control buttons array, the plug-in control interface and the hint line.
Title Bar
The title bar shows hint enable switch, plug-in’s title, and also contains the Plug-In
Instance Name text box, the Oversampling selector and the “Bypass” switch. Note
that this title bar will not be visible if the “Min Infrastructure” option in the “Settings”
window was enabled.
Some plug-ins have differently-looking title bar that only displays plug-in’s title with
one or several control buttons.
Control Buttons
This part of the user interface contains several control buttons: the “Presets” button
which opens the preset manager popup window; the quick preset selector “down”
button; three change history-related buttons; the A/B comparison button; the “A > B”
(“B > A”) button; the “Routing” button which opens the channel routing popup
window; the quick routing preset selector “down” button; the channel group selector;
and (at the far right) the “Settings” button which opens a popup window with the
plug-in’s copyright information and additional settings.
Hint Line
This interface element displays hint messages and may also display other
informational messages. The hint line can be enabled with the “?” button.
6
Voxengo Primary User Guide
Every Voxengo plug-in features a set of standard control buttons. They are shown
and described below.
Oversampling Selector
This selector allows you to select a “quality factor” for the plug-in. An oversampling
allows a plug-in to run on a higher internal sample rate thus offering a better overall
sound quality. Almost all types of audio processes benefit from an oversampling:
probably, only gain adjustment, panning and convolution plug-ins have no real use
for it. An oversampling helps plug-ins to create more precise filters with minimized
warping at highest frequencies, to reduce spectral aliasing artifacts in compressors
and saturators, to improve a level detection precision in peak compressors. The
higher the oversampling setting is, the more CPU resources plug-in will require since
a CPU load is increased proportionally to the specified oversampling setting: at the
“8x” oversampling setting plug-in uses exactly 8 times more CPU time (and that is
excluding the time necessary to perform the oversampling itself).
The “Auto” oversampling option is the special option that enables the oversampling
when a project is being bounced (exported) to a wave file; in this mode, when the
plug-in works in the real-time mode the oversampling is set to the “1x” option (some
plug-ins may use “2x”). If the “Auto” option was not used then the selected option
will be used during bouncing. It should be noted that not all audio host applications
provide the plug-in with the required plug-in state information: in those cases the
“Auto” option works as the “1x” (or “2x”) option all the time (this is the case for some
older Mac OS X audio host applications that do not report the off-line bouncing state
to the plug-in). The “Auto” oversampling mode engages the “4x” oversampling mode
if the working sample rate is below 72 kHz; the “2x” mode is engaged if the sample
rate is below 144 kHz; otherwise the oversampling is not engaged at all (for example,
if the working sample rate is equal to 176.4 kHz or 192 kHz the oversampling is not
engaged). The maximum oversampling level used when the “Auto” mode is engaged
can be adjusted in the global settings window. Note that when the plug-in enters the
bouncing state, the “Off-Line Render” notification will be displayed on its interface.
When this notification is displayed, the “Auto” oversampling option will be working
correctly.
In the “Settings” window of most Voxengo plug-ins you can choose the oversampling
filter type to use. When the “Min-Phase” type is selected Voxengo plug-ins are using
poly-phase IIR low-pass filters with at least 106 dB stop-band attenuation and 6%
7
Voxengo Primary User Guide
transition band’s width (which starts at Fs/2) for the oversampling. Please note that
these poly-phase filters impose a phase coloration which sounds slightly different at
various working sample rates.
Voxengo plug-ins using the “Lin-Phase” filter type use linear-phase filters with 150
dB stop-band attenuation and 4% transition band’s width (centered at Fs/2). Note
that while working at 44.1 kHz sample rate, linear-phase oversampling filters will cut
frequencies above 20 kHz. This is a standard side-effect of oversampling and should
be considered normal.
Please also read the part titled “Oversampling” under the “Plug-In Settings for a
Specific Plug-In” topic.
Bypass Switch
The Bypass switch was mainly designed for evaluation of changes the plug-in made.
The Bypass switch will not reduce the plug-in's CPU load when switched on.
Sat Switch
Some plug-ins feature a built-in soft-knee output limiter. This switch enables this
limiter. This limiter controls output signal level and produces “console saturation”
effects. Note that neither limiter mode nor soft-clipping threshold is adjustable.
8
Voxengo Primary User Guide
Standard Controls
Knob
The knob control consists of four parts: the name of parameter it controls, the knob
position marker, the center of the knob, and the parameter value readout.
The knob position marker is represented by a rounded light indicator. You may drag
this marker to adjust the value of the parameter using the circular knob adjustment
approach: during dragging, you may move the mouse cursor farther away from the
knob to increase parameter value adjustment precision. You may click on the marker
to set the desired parameter value immediately. This way of adjusting the knob is
available only if the “Radial Knob Mode” global setting was enabled.
The center of the knob has a defined color that corresponds to the parameter or
parameter group the knob controls. You may drag the center of the knob to adjust
the value of the parameter with up and down mouse movements, linearly. While
dragging the center of the knob with the left mouse button, by additionally pressing
the right mouse button you can enable a high precision adjustment mode (which can
otherwise be enabled by holding down the “Shift” key). Dragging precision can be
adjusted in the global settings window.
The parameter value readout displays the current value of the parameter.
When knob is hovered with the mouse cursor, a scale ring is displayed that shows
approximate parameter values at different knob positions (“knob labels”). Thousand
values are suffixed with an asterisk (e.g. “2*”). This ring can be disabled in the global
settings window.
In some plug-ins you may use the right mouse button to enable knob linking. The
linking between knobs is available when two given knobs are logically linked (for
example, input and output gain knobs, low and high frequency knobs, etc.). You may
hold the “Ctrl” (“Command” on Mac OS X) key before dragging a knob with the right
mouse button to enable inverse knob linking: in this mode every positive increment
of the knob you drag results in a negative increment in the linked knob.
Knob can be also controlled with the mouse wheel. Double-clicking on the knob
resets it to the default state.
9
Voxengo Primary User Guide
This type of control allows you to choose a value or an option from the list. You may
press the selector button with the left mouse button to display the value list. If you
later depress the mouse button on the desired value instead of the selector itself, the
list will be closed and the value on which you have depressed the mouse button will
be selected.
Note that mode preset lists are different to value lists in that mode preset lists do not
highlight a currently selected mode when you open the list.
Value and mode preset lists offer you additional ways of item selection without
opening the list: you may use mouse’s “forward” and “backward” buttons and mouse
wheel to scroll through the values. You may press the right mouse button on a value
selector (but not on a mode preset selector) to switch between the current and default
values.
Slider
Voxengo plug-ins feature horizontal and vertical sliders. A slider can be dragged with
the left mouse button to perform adjustments. While dragging the slider with the left
mouse button, by additionally pressing the right mouse button you can enable a high
precision adjustment mode (which can otherwise be enabled by holding down the
“Shift” key).
If plug-in presents you an array of sliders (like the “Overtone GEQ” plug-in does) by
holding down the right mouse button on the slider array you will engage the
“drawing” mode that allows you to position sliders in the “free-hand” mode.
Level Meter
Many Voxengo plug-ins feature standard level meters. Each level meter contains
level scale ruler (in decibel) and several level bars that correspond to channels (“A”,
10
Voxengo Primary User Guide
“B”, etc.) of the currently selected channel group (level meter displays all available
channels if the “Show All Channel Meters” switch was enabled in the “Channel
Routing” window). In some cases level meters are shown in the “minimal” variant
with only a single level bar present that averages level from all channels that belong
to the currently selected group.
Gain reduction meters are displayed inversely (from top to bottom), and may show
positive gain reduction values since, if not specified otherwise, they are showing gain
reduction changes relative to the average gain reduction over 2-second time frame.
This type of gain reduction metering displays “dynamic coloration” that occurs during
compression: this way it is very easy to spot how much “colored” the sound becomes.
Such “relative” gain reduction metering is non-conventional, but it may be very
effective at understanding how much signal is changed dynamically rather than
constantly. The “out/in” indication on the level meter further displays
average/constant gain reduction applied by the plugin.
Level meters may show a small horizontal white bar which represents peak level. In
output level meters such peak level may turn red which means that the output level
has entered the area above the 0 dBFS signal level and clipping may occur if the plug-
in stays last in the audio host application’s signal chain (if the plug-in is staying in the
intermediate position before other plug-ins clipping may not necessarily occur). In
non-output level meters used in the plug-in a red peak level may be only an
informative indication that some predefined threshold level was reached.
Level meter ballistics and peak level hold time can be defined for all instances of the
plug-in in the “Settings” window.
Output level meters usually feature the “Out/In” readout that displays the RMS level
difference between the input and output signals of the plug-in (this level difference
estimation is based on 3-second integration time).
Equalizer
Several Voxengo plug-ins feature an equalizer with the built-in real-time spectrum
analyzer. While the visual appearance of the equalizer is similar among Voxengo
plug-ins, the equalizing algorithm used by any given plug-in may be different from
other plug-ins.
Note that information contained in this chapter applies to parametric equalizers only,
this part does not apply to envelope-driven equalizers like CurveEQ – please refer to
the Envelope Editor chapter for information on envelope editing.
This picture shows the “control surface” with control points which can be dragged
with the left mouse button to adjust the filter's gain and frequency that corresponds
11
Voxengo Primary User Guide
to this control point (you may additionally hold the “Shift” key to enable precise
adjustments).
You may select the filter type of the control point by pressing the right mouse button
on that control point. By default, the filter type is set to “Off” making the control
point appear grey. Alternatively, you may use the mouse’s “forward” and “backward”
buttons to scroll through the filter types.
The readouts you see show mouse cursor position within the control surface. The
readout also displays the musical note (and detune in cents) that corresponds to the
frequency position. The rightmost readout shows mouse cursor’s position within the
spectrum power range.
Clicking on a control point with the mouse button will cause the point to be encircled,
and the corresponding filter's frequency response curve will be shown in orange. The
white curve shown in the equalizer window shows the summary frequency response
of all currently enabled filters. When the control point is encircled, three entry fields
will be also displayed which you can use to specify filter’s parameters via keyboard
precisely (these entry fields may not be available in a particular plug-in).
While dragging a control point with the left mouse button, you can adjust the filter's
bandwidth by additionally holding the right mouse button (or holding down the “Alt”
key). Alternatively, you can use the mouse wheel to adjust the filter’s bandwidth.
You can hold the “Ctrl” (“Command” on Mac OS X) key while dragging a point to
enable its gain adjustment only; holding the “Ctrl” (“Command” on Mac OS X) and
“Alt” key simultaneously enables control point’s frequency adjustment only. Double-
clicking on a control point with the “Ctrl” (“Command” on Mac OS X) key held
returns this point to the 0 dB gain position.
Double-clicking on a control point without any key being held temporarily disables it.
Second double-click will re-enable the control point. A disabled control point will be
re-enabled whenever you move it. Some plug-ins may allow you to double-click or
Shift+Click the control surface anywhere to add a new filter (the filter type will be
auto-selected depending on the frequency where the filter was added at).
You can also perform editing operations on a group of control points. To select
several control points, drag inside the control surface itself. A box will appear, and all
control points inside this area will become selected. Later you can move a group of
selected points like you are working with a single point. To add control points to the
current selection, you have to hold the “Shift” key before starting to drag inside the
control surface. While holding the “Shift” key, instead of dragging you may also click
on the control point you want to add or remove to/from selection. If several points
12
Voxengo Primary User Guide
were selected the double click on any of the selected points with the “Ctrl”
(“Command” on Mac OS X) key held will reset all selected points to 0 dB.
To deselect any currently selected points, simply click the control surface anywhere.
You may right-click the control surface to select all control points at once.
If several control points are selected, dragging them up and down scales the gains of
these filters up and down, up to the point of gain inversion.
The “Presets” button opens preset manager for the equalizer.
Equalizer – Spectrum
Beside control points and frequency response plot the equalizer window also displays
the Fourier spectrum analysis plot. The spectrum analysis and displaying parameters
can be selected via the “Spec” mode selector. The “Spectrum Mode Editor” can be
used to customize these parameters further. You may also click the control surface
with the left mouse button anywhere to reset spectrum analysis display. Note that
Voxengo plug-ins by default use the Hann windowing function to perform FFT
analysis.
A red vertical line that can be displayed if the visible frequency range is wide: this line
shows maximal frequency of the input signal and depends on the input sample rate.
A second red vertical line may be displayed if oversampling is in use – this second
line informs you about the internal frequency range used by the plug-in at this
moment. Note that until you start the audio playback the red line may not be placed
correctly, because the plug-in may not know the correct input sample rate before the
audio processing was started.
Note that by default Voxengo plug-ins use 4.5 dB per octave slope for the spectrum
display which makes it look considerably “elevated” towards the higher frequencies in
comparison to most other spectrum analyzers available on the market. This setting
can be changed in the “Spectrum Mode Editor” window. The slope is defaulted to
such non-zero value, because the power spectrum of contemporary music very closely
follows this slope; by applying the slope, it becomes more easier to evaluate the
spectrum.
If the spectrum does not fit the display, you may adjust the visible spectrum range in
the “Spectrum Mode Editor” window.
13
Voxengo Primary User Guide
Envelope Editor
Some Voxengo plug-ins feature an envelope editor. The function set of this editor is
basically the same as that of the equalizer. The main difference lies in the manner the
curve is being drawn. Control points in the envelope editor are always connected by a
line or a smooth curve, without intersections, and there are no “filters” with their
corresponding “filter shapes” attached to each control point. In the envelope editor
you may add and remove control points freely by double-clicking or Shift+click in the
desired position within the envelope editor’s area.
To delete a control point you should double-click it. The leftmost and rightmost
control points cannot be deleted – they will be moved to envelope’s default position
when double-clicked. If you are double-clicking a control point with the “Ctrl”
(“Command” on Mac OS X) key held, the control point will be set to envelope’s
default position.
While any single control point can be moved freely around the control surface,
movements of grouped control points are constrained. There are two types of group
movements possible: when you drag a control point (when more than a single control
point is selected) the vertical movement is constrained and you can move points
horizontally; when you drag a line segment the horizontal movement is constrained
and you can move points vertically. If you hold the “Ctrl” (“Command” on Mac OS X)
while dragging the constraints are removed. The mouse wheel can be used to move
the control point closest to mouse cursor’s position vertically.
Quick Zoom-In
You may hold the Alt key while dragging the control surface to zoom-in the selected
spectrum area. Double-clicking the control surface with the left mouse button while
the Alt key is held acts as zoom-out function.
Scroller
Some Voxengo plug-ins feature horizontal and vertical scrolling controls with
zooming functionality. Such scrollers are usually attached to the sides of an equalizer
“control surface” discussed above. You may move a scroller only after using its
zooming function.
A pair of horizontal and vertical scrollers is accompanied by a rhomb which can be
used to control position of both scrollers at once in a single X-Y coordinate space.
14
Voxengo Primary User Guide
Scrollers and rhombs can be double-clicked to switch the visual state of the view they
are attached to. You may use this functionality to quickly switch between zoomed
and non-zoomed visual states of a view.
Window Resizer
This control that is present in some Voxengo plug-ins and is located in the bottom
right corner of the user interface window can be dragged to adjust the size of the
window. Note that some audio host applications may not allow you to adjust plug-
in’s window freely – in that the window will appear cropped after resize.
The “Spectrum Disable” switch completely disables spectrum analysis function of the
plug-in.
The “Type” selector specifies which spectrum analysis type should be used. The “RT
Avg” mode engages the real-time spectrum averaging analysis. This type of analysis
produces averaged spectrum over the specified period specified by the “Avg Time”
parameter. The “Max” type of analysis produces cumulative maximum power
spectrum. If you need an “infinite” peak hold, please use the “Max” analysis type.
The “Avg” type of analysis produces cumulative average power spectrum. The “RT
Max” produces real-time maximum spectrum with spectrum fall-off (for better
spectrum maximum estimate it is suggested to use a higher “Overlap” setting). The
“RT Sigma” produces sigma spectrum which shows how much dynamic certain
spectral areas are. The best way to use the “RT Sigma” mode is together with the “RT
Avg” mode. This way you can easily see spectral areas that are more or less dynamic:
the areas that are highly dynamic will be displayed above the “RT Avg” spectrum, the
less dynamic areas will be displayed below it.
The “Filled Display” switch enables additional semi-transparent filling of the
spectrum area.
The “2nd Spectrum” switch enables the secondary spectrum curve which is displayed
in a darker color. The “2nd Type” selector selects analysis type to use for the
secondary spectrum. For example, by setting the “2nd Type” to “RT Max” and “Type”
to “RT Avg” you may see the average and maximum spectrums simultaneously. Note
that the secondary spectrum uses the same “Block Size” and “Avg Time” parameters
as the primary spectrum.
15
Voxengo Primary User Guide
The "Block Size" selector specifies the block size of the FFT (fast Fourier transform)
spectrum analyzer. Higher block sizes provide more resolution in the lower
frequency range, but decrease time coherence (time precision) in the higher
frequency range – the higher frequency information becomes over-averaged. Also, at
higher “Block Size” settings the spectrum is refreshed less frequently. This can be
mostly fixed by increasing the “Overlap” parameter which increases spectrum refresh
frequency.
Note that you will generally need to increase the “Block Size” when working at
increasingly higher sample rates since the specified “Block Size” setting is used over
the full spectral bandwidth, and so at higher sample rates analyzer’s resolution in the
visible frequency range will be lower for the given “Block Size” setting.
If you would like to measure frequency of a low-frequency sound (e.g. bass drum or
bass guitar) precisely you should use a higher “Block Size” parameter value along
with a higher “Overlap” parameter value. You may naturally need to set a higher
“Overlap” value with a higher “Block Size” value because otherwise the spectrum
display will be blinking.
In order to avoid clicks and glitches in playback when using high “Block Size” values
you may need to increase the audio buffer size in your audio host application.
The “Window” selector specifies windowing function used for FFT analysis. The
default “Hann” window is best used for music analysis as it offers a superior
separation between adjacent frequencies, this is especially important at lower
frequencies. The “Hi-Res” window is a non-conventional window (“Nuttall” squared)
designed for technical analysis: when using this window it is possible to measure the
noise-floor and detect various spectral artifacts. The “Blackman” window offers a
slightly better dynamic range in comparison to the “Hann” window and at the same
time it has a better separation between frequencies in comparison to the “Hi-Res”
window.
The “Overlap” parameter controls the time overlap between the adjacent FFT
spectrum analysis blocks. E.g. 80% means the block currently being calculated is
overlapped with the previously calculated block by 80% in time. Higher overlap
values allow spectrum to be updated more frequently at the expense of a higher CPU
load.
The “Avg Time” parameter specifies averaging (fall-off) time (in milliseconds) used
when the “RT Avg” or “RT Max” analysis is active. This value specifies time it takes
spectrum level to fall down by 20 dB.
The “Smoothing” parameter selects spectrum smoothing function’s resolution in
octaves. Note that smoothing being solely visual produces 6 dB per octave drop when
stationary sine-wave signals are analyzed. E.g. even if the signal consists of 2 sine-
waves (1 kHz and 2 kHz) of equal peak amplitude, the 2 kHz sine-wave will look like
it is 6 dB quieter. This happens because fast Fourier transform produces a narrower
spectrum for high-frequency stationary signals in comparison to low-frequency
stationary signals. This drop does not practically appear when non-stationary
(musical) signals are being analyzed.
The “Offset” parameter selects spectrum’s offsetting. The “Normalize” offset mode
normalizes all spectrums so that the loudest frequencies are displayed on top. The
“Center” offset mode centers all spectrums: this mode can be especially useful when
comparing several spectrums as it removes the overall loudness factor from the
comparison.
16
Voxengo Primary User Guide
The “Freq Low” and “Freq High” parameters (if they are available in a given plug-in)
specify the accessible (and visible) frequency range (in Hertz) of the spectrum view.
The “Range Low” and “Range High” parameters select accessible (and visible)
spectrum power range (in decibel).
The "Slope" selector (which is defined in dB per octave) allows you to adjust spectrum
analyzer display’s slope around 1kHz. Skewing the spectrum can be useful because
higher frequencies usually have weaker power in comparison to the lower
frequencies. By choosing an appropriate spectrum slope, you can compensate for this
fact and make the spectrum plot look more convenient and meaningful.
The “Anti-Alias” switch enables anti-aliased spectrum curve drawing.
This window allows you to fine-tune the DC filter, and create user presets if required.
DC filter (also known as high-pass filter) is applied after all processing stages, and is
used for removing ultra low-frequency content introduced by plug-in’s processing
modules.
The “DC Filter Enable” switch enables DC filtering stage.
The “Freq” parameter specifies the corner frequency of the DC (high-pass) filter.
The type selector specifies DC filter type. The “Steep” filter types offer a steeper
cutoff frequency response, but a higher phase shift. The “Soft” filter types have a
smoother cutoff frequency response and a lower overall phase shift. The number
before the filter type denotes dB/octave roll-off of the filter (e.g. “-18 Soft” means “-18
dB/octave soft filter”).
Note that DC removal filter induces phase shift and thus may affect sonic character of
a sound material. For best results you may specify DC filter frequency as low as
possible and use non-steep filter types (preferably, -6 dB/octave one). Due to its
phase shifting, the DC filter may be also used creatively to adjust the sonic character
of a sound material in the low-frequency region.
17
Voxengo Primary User Guide
Some Voxengo equalizer plug-ins feature static spectrums display that can be
controlled via the editor window shown above. You may select the display name of
the spectrum slot, its color, the shift in decibel of the static spectrum on the control
surface. The static spectrum can be shown or hidden via the visibility check box. The
shift in decibel can be used for a more convenient placing of the static spectrum on
the screen, and it does not affect the shape of the spectrum.
The “Take” and “Take 2nd” buttons take a snapshot of the primary or secondary
spectrum, respectively. The static spectrums you “take” use spectrum parameters
specified in the “Spectrum Mode Editor”. If after pressing any of these buttons no
spectrum is taken, it means that no spectrum is currently available – you either have
to configure the spectrum mode or start the audio playback first. Before taking a
spectrum, please do not forget to choose an appropriate spectrum analysis type via
the “Spectrum Mode Editor” – usually “Avg” or “Max” (or you may simply load the
factory “Average” or “Avg+Max” spectrum mode preset), and analyze long enough so
that spectrum becomes general enough. When analyzing a song, it may be a good
idea to store separate spectrums for verse, chorus and bridge parts as they may have
distinctively differing spectral balance.
The “Predef” button allows you to load one of the predefined static spectrums.
The “Load” and “Save” buttons allow you to load and save the spectrum file into the
static spectrum slot. The files have the “.csf” (compressed spectrum file) file
extension. Note that you can also load spectrum from a Wave PCM sound file (“.wav”
file extension).
The “x” button resets the spectrum in the selected slot.
When a spectrum is available in the static spectrum slot, the spectrum’s parameters
are also displayed. They correspond to parameters that were configured via the
“Spectrum Mode Editor” when the spectrum was taken.
The “Filled Display” switch enables display of all static spectrums in a filled form.
The “Spectrum Mode” selector in this window was added for a quick access to
spectrum mode presets: it is equivalent to the spectrum mode selector and editor
located on the main plug-in window.
18
Voxengo Primary User Guide
Undo/Redo
Voxengo plug-ins offer a convenient way of managing changes you apply to the plug-
in’s state. When you apply a change to any control, its previous and new values are
stored in the special “change log” which you can then use to “unwind” and “rewind”
any previously made changes. This way you can be sure that no single unwanted or
occasional change you do affects the state of the plug-in in a wrong way.
Undo/redo control consists of three buttons: the “Undo”, the “History” and the
“Redo”:
The “Undo” button allows you to un-do changes made to the plug-in’s state.
The “Redo” button allows you to re-do changes that were already un-done via the
“History” or “Undo” buttons.
The “History” button opens change log (history) that lists all changes made to the
plug-in’s state in the order you have made these changes before. You can re-do and
un-do changes to any level of depth, instantly. Change log keeps track of last 32
changes you have made. Note that a parameter change is logged with group name
placed in parentheses (e.g. “Gain (Ls) change”).
19
Voxengo Primary User Guide
Preset Manager
Presets in the main preset manager are shared among all instances of the same
Voxengo plug-in. All presets within the main preset manager are stored in user
preset banks. Beside user preset banks two special banks exist: the “Session Bank”
and “Factory ROM” bank.
The “Session Bank” contains “programs” rather than presets. Each program in the
“Session Bank” contains its own undo/redo change log, meaning that when you
switch the program in the “Session Bank” you are also switching the undo/redo
context. A currently selected program is specified by the “right allow” symbol. The
“Session Bank” lists programs that “mirror” programs of the VST audio host
application (in AudioUnit-compatible applications this bank can be used as a
temporary preset palette). When you are activating a program in the “Session Bank”
you are actually switching the current program in the VST audio host application (in
AudioUnit-compatible applications program switch in the “Session Bank” is similar
to a plain preset switching).
The “Factory ROM” bank lists presets that were pre-programmed by the plug-in's
producer. These presets cannot be changed, but can be activated. The “Factory
ROM” bank is also loaded into the “Session Bank” every time a new instance of the
plug-in is created in the audio host application.
The main preset manager contains the following control buttons:
The “+”, “–”, “Load” and “Save” buttons allow you to add and remove the bank or
preset, and load and save the bank or preset to and from a disk file. Right-clicking
the “+” button inserts preset into the current list position rather than to the end of the
list if the left mouse button is clicked. The “U” button allows you to update a
currently selected preset by storing the current plug-in state in it.
Please note that Voxengo plug-ins use a proprietary format to store presets and
preset banks. We suggest that you add a comprehensive name prefix to bank and
preset files so that you would not mix up presets created in different Voxengo plug-
ins. During a save operation, the plug-in will offer you a default name prefix
20
Voxengo Primary User Guide
automatically. Voxengo plug-in preset files possess the “.cpf” file extension while
preset bank files possess the “.cbf” file extension.
The “Set as Default” button allows you to designate a selected preset to become the
default preset. If you want to restore the original default preset you should press the
“Set as Default” button on the “Default” preset in the “Factory ROM” preset bank.
Double-clicking on a preset name loads the specified preset state. The same does the
“Activate” button. A preset load operation can be undone by pressing the “Undo”
button.
To change a name of the preset or bank you should at first select the required item
and then after a small delay click the item again. Please do not mix this operation
with a double-click which activates a selected preset.
Local preset managers usually manage presets for a specific module of a specific
Voxengo plug-in. The “Update” button can be used to quickly update selected preset
to the current state.
Presets available in the “Routing Presets” local preset manager are globally accessible
to Voxengo plug-ins of all kinds. These presets greatly minimize routine adjustments
you usually need to perform after creating a new plug-in instance in your audio host
application. Routing presets that are not compatible with the current plug-in are
shown grayed out with the “(n/a)” prefix.
21
Voxengo Primary User Guide
Layout
The “Channel Routing” window consists of a set of selection buttons assembled in the
following groups: the “Input Routing”, the “Mid-Side Pairs”, the “Group
Assignments”, the “Key Signal Sources” and the “Output Routing”:
22
Voxengo Primary User Guide
and thus requires two channels to be assigned to the same mid-side pair. An input
signal is mid-side encoded before it is processed by the plug-in, and decoded
afterwards before it is routed to an output of the plug-in.
23
Voxengo Primary User Guide
In Channel Labels
By pressing this button you can open the channel label assignment popup window.
You can give individual names to input channels in order to simplify a further
channel routing setup understanding. Channel names you provide are also displayed
on the user interface to inform you about channels that are currently being adjusted
by the plug-in’s controls.
You can also import channel labels from the audio host application by pressing the
“Import labels from host” button. However, not all audio host applications provide
distinctive input channel names: in that case entering your own names manually is
the only existing option (Mac OS X AudioUnits do not provide input channel names).
Group Names
This button opens the group name assignment popup window. You may assign
names to channel groups for easiness of channel group selection.
Routing Presets
The “Routing Presets” button opens a local preset list that covers settings present in
the “Channel Routing” window, including channel labels. These presets are shared
among Voxengo plug-ins of all types: note that due to this fact a particular preset (e.g.
the one that uses mid-side pairs or external side-chain assignment) may not be
applicable to a specific plug-in where the used feature is unavailable (not all plug-ins
possess mid-side processing and external side-chain) – in this case such preset will be
shown grayed out, with the “(n/a)” prefix.
24
Voxengo Primary User Guide
Almost every Voxengo plug-in features the channel group selector which allows you
to select the channel group for which parameters are currently being edited or
monitored.
This selector, when pressed, displays a selection of channel group names (indices, by
default). Only groups actually assigned to the internal channels in the Channel
Routing window are shown. You may use this control to switch between channel
groups.
The “Solo” switch allows you to solo channels that belong to the currently selected
group. This can be useful if you want to focus listening on group’s channels only (for
example, in “Mid-Side Stereo” routing setup). The state of the “Solo” switch is not
saved between project sessions, and is not restored to its previously enabled state
when the project is reloaded.
The “Copy to” button allows you to copy parameter settings defined for the current
channel group, to another channel group.
A Voxengo plug-in also presents a list of input channels being routed to a currently
selected channel group. This list is interconnected with the “Channel Routing”
window, and displays routing settings defined by it. This list contains names of input
channels, comma delimited. Internal channel name (“A”, “B”, “C”, etc.) that accepts
the corresponding input channel is displayed in a superscript style (these internal
channel names are also displayed on the level meters). If more than one input
channel is routed to the same internal channel, the sum is displayed in the form
“(IN1+IN2)”. Additionally, when the internal channel is assigned to a mid/side
group, its input channels are taken into parentheses with the “m” (mid) or “s” (side)
prefix: “s(IN1 & IN2)” which means “side part of the mid/side pair consisting of IN1
and IN2 input channels”.
When a plug-in supports side-chain, any side-chain assignments are displayed with a
special postfix: “:sc()”. For example, “L:sc(scL)” means that the input channel “L” is
affected by the side-chain signal from the input channel “scL”.
25
Voxengo Primary User Guide
Voxengo plug-ins feature a set of settings that affect instances of the same plug-in
only: they do not affect the same settings of other Voxengo plug-in types. This is
convenient since this way you can select different color schemes for different plug-in
types (for example, a Voxengo compressor may be colored in reds while a Voxengo
equalizer may be colored in grays). The same applies to the user interface scale and
the hints display switch: for example, if you have not still mastered a specific Voxengo
plug-in you may leave the hints for this plug-in visible while you may disable the
hints for a Voxengo plug-in you know well.
Color Scheme
The color scheme selector consists of several small preview icons that show possible
color scheme selections. You may press a desired icon to change the color scheme of
all instances of the plug-in. Color scheme switches immediately in all open plug-in
instances, and instances that will be opened later.
Min Infrastructure
This switch enables the “minimal infrastructure” look of the user interface. Such look
reduces the visual complexity of the user interface by hiding several infrastructural
elements like the instance name box, oversampling selector, bypass switch, plug-in's
name and version labels on top, and the group selector on the bottom of the user
interface.
Oversampling
This selector, if available in a particular plug-in, allows you to choose the type of
oversampling filter to use. Oversampling is discussed in the topic “Main Control
Buttons – Oversampling Selector” above. The “Min-Phase” option selects minimum-
phase oversampling filter which is easy on CPU and does not add a considerable
processing latency. The “Lin-Phase” option selects linear-phase oversampling filter
26
Voxengo Primary User Guide
27
Voxengo Primary User Guide
28
Voxengo Primary User Guide
Voxengo plug-ins also feature global settings that are shared among all Voxengo
software types. These settings mainly customize your interaction with various
controls: mouse wheel precision, knob drag precision, etc.
Drag Precision
This setting affects precision of mouse drag operations. This setting applies to knobs,
level meters and readouts only.
Tablet Mode
This switch enables “tablet” mode allowing you to control Voxengo audio plug-ins
with a pen tablet. This mode can be also used if you are operating plug-ins via remote
desktop software. If this mode is not enabled, the mouse cursor will be hidden on
every mouse dragging operation.
29
Voxengo Primary User Guide
30
Voxengo Primary User Guide
Anti-Denormal Noise
This switch enables insertion of anti-denormalization noise on plug-ins’ inputs. This
noise has loudness of -220 dBFS – well below the audible dynamic range. If you are
using Voxengo plug-ins in an audio host application that applies such noise
automatically you may disable this switch to preserve some CPU resource. Without
this anti-denormal noise the filters and oversampling of the plug-in may overload
CPU when silence signal is being processed.
No Multi-Channel Operation
This switch forces stereo and mono (no multi-channel) operation in Voxengo plug-
ins. Enable this switch if you are using VST 2 audio host applications that do not
support multi-channel VST plug-ins correctly. To take effect, this switch requires
audio host application restart.
Visual Settings
Latest Voxengo software features a set of visual settings that allow you to subtly
customize the look of the plug-ins. These settings are:
1. Flat Panels – when enabled, all buttons and panels will look flat, without gradient
fill.
2. Spotlight – enables a wide light area that looks like a trace of spotlight.
3. Textures – enables texturing of the panels.
4. Shadows – enables shadows on visual elements.
5. Flat Level Meters – enables the “flat”, non-blocky look of the level meters.
6. Frames Per Second – specifies user interface refresh frequency.
7. High-Precision Timer – this setting is available on Windows systems, engages a
high-precision user interface timer which reduces visual stuttering, may use more
CPU resources in comparison to the legacy lower precision timer, so FPS setting
may need to be lowered. On Macintosh systems the user interface timer always
runs in high-precision mode offering minimal stuttering.
31
Voxengo Primary User Guide
Any Voxengo software title is bundled in a separate archive or installation file for
every target platform. These archives contain document files, a license agreement, a
change history log and a plug-in or application itself in the form of the dynamic link
library (DLL) or the component file, or executable file for any given target computer
platform.
In order to be able to instantiate the plug-in in an audio host application you should
put the DLL (component) file into the correct file folder that corresponds to the
“plug-ins path” specified in that audio host application. It is suggested that you put
the DLL (component) file into the “Voxengo” subfolder within the plug-in folder, for
easier searching.
While it is mandatory to read and agree to the supplied license agreement before
using the plug-in, you may for your convenience put the DLL (component) file
separately from its accompanying files, including the license agreement file.
However, as license agreement explicitly mentions, the DLL (component) file cannot
be re-distributed to other persons or companies/entities separately. You may store
the DLL (component) file separately from its accompanying files for your own
archival and storage convenience purposes only.
During its operation, the software also creates settings files where it stores global and
per software title settings, including presets. On Windows systems the data files
created by Voxengo software reside in the hidden “\Users\<UserName>\ Application
Data\Voxengo\” folder (on Windows systems prior to Vista the root folder is called
the “\Documents and Settings\” instead of “\Users\”); on Mac OS X systems the data
files reside in the “/Users/<UserName>/Library/Preferences/Voxengo/” folder. You
may safely remove, copy and replace these files, including the whole “Voxengo”
subfolder. All Voxengo settings and presets are available to the specific user of the
computer only.
32
Voxengo Primary User Guide
Additional Information
Plug-In Registration/Authorization
Commercial Voxengo software titles should be registered (authorized) before you can
use them in non-demo mode. Each commercial software title in its Settings window
contains a special area where user registration/authorization details can be entered.
Please use the standard copy&paste functions to ensure a correct product key entry
(you may right-click the product key entry field to paste the key). User name is not
required for entry. When details were entered correctly, you will see the “Registered
to” text in the Settings window: in this case plug-in is working in a non-demo mode.
33
Voxengo Primary User Guide
Stereo Correlation
Speaking about stereo (two-channel) signals, “acceptable” correlation value range lies
between 0.0 and 1.0. Negative correlation values mean that channels are out of phase
and this usually works problematically – stereo field becomes “unreal” (“surround”)
and causes disorientation. Beside that, out of phase stereo information is not mono-
compatible and such signal sounds poorly if the listener is not placed on the central
listening axis.
In order to create any useful spacious stereo-image the correlation values close to 0.0
should be used. Also note that an uncorrelated stereo-signal in comparison to a
correlated stereo-signal at an equal peak level usually sounds louder to the listener by
around 1.25 decibel, because uncorrelated channel sound coming from a speaker does
not cancel channel sound coming from another speaker spaced 60-degree apart from
it as much as correlated channel sound cancels it.
34
Voxengo Primary User Guide
This topic discusses possible ways of achieving a good alignment between several
microphones providing a maximally focused and feature-rich sound. While this topic
is easier perceived from the perspective of Voxengo PHA-979 plug-in user,
information contained herein can be used universally.
When you are placing a couple of microphones to capture a single instrument, this
means you are creating a microphone array consisting of two microphones.
When doing microphone alignment you should always consider only two
microphones and a single sound source at a time. One of the microphones should be
considered as the “master” microphone and its delay, phase and gain should not be
changed. When working with three or more microphones in an array, each additional
microphone should be aligned to the master microphone, one by one, so that only two
microphones are considered at a time.
Each microphone in this array has these basic parameters: distance from the sound
source, delay relative to the master microphone and phase relative to the master
microphone. Relative delay can be negative meaning the sound reaches the
microphone earlier than it reaches the master microphone.
All directed microphones should generally capture a single sound source or otherwise
you may face problems getting all sound sources to sound good when trying to align
microphones, because in such case you will have to make complex decisions to find a
good balance of per-microphone phases and delays.
Alignment Steps
Aligning any given microphone in the array relative to the master microphone
basically consists of three steps: 1) finding an optimal delay; 2) finding an optimal
phase; 3) finding an optimal gain.
First of all, it should be said that microphone delay, phase and gain alignment is
required only if you are capturing the direct sound of an instrument with a
microphone array. Microphone gain alignment may become unimportant or even
problematic if you are capturing “space” where the instrument is located (i.e.
surround microphone array, room microphones, etc), because at longer distances
from the sound source the microphones may capture room’s reflections in larger
volumes than instrument’s direct sound.
35
Voxengo Primary User Guide
distances by 344 meters per second (average speed of sound propagation in air) to
obtain the delay of the microphone relative to the master microphone, in seconds.
However, this method gives only approximate results, because the actual speed of
sound propagation in your recording room may be unknown, and the exact distance
from the microphone to the sound source cannot be usually measured precisely since
it may be unknown which part of the sound source emits the sound first.
36
Voxengo Primary User Guide
reaching the microphones and which may cause interference, effectively increasing or
decreasing the signal power of the recording.
Why Go Multi-Microphone?
If you generally wonder why one should use multi-microphone arrays instead of a
single microphone when recording a sound source, you should understand that
various acoustical instruments have quite a complex sound emitting profile: the
spectral content of a sound emitted from side, front, bottom, etc. surfaces of the
instrument may be quite different.
For example, snare drum’s batter drumhead side does not have much “crack” sound
in it while snare drum’s body side provides a lot of “crack”; on the bottom of the snare
drum the sound of resonating snares is prevailing. All these aspects cannot be
captured with a single microphone if one wants to achieve defined and focused
recorded sound: getting such sound requires close placement of several microphones
with a further time and phase alignment of the recorded microphone tracks.
37
Voxengo Primary User Guide
Q. I may hear that when I switch from the 44.1 kHz working (project)
sample rate to the 96 kHz sample rate the overall plug-in’s sound changes
a bit. Is this normal?
A. This is an expected plug-in behavior since the working sample rate may affect
several internal signal processing aspects, especially digital filter shapes. Thus we are
making an expressed disclaimer about the plug-in’s sonic qualities when working at
different sample rates: the plug-in may produce sonically different results working at
different sample rates. However, these differences are usually minor any should not
be construed as an invalid plug-in operation. It should be also noted that Voxengo
plug-ins are designed to work at any sample rates equal or above 44.1 kHz: lower
sample rates are not supported.
Q. Could you please tell me an easy way to setup mid/side processing over
a stereo input?
A. To setup mid/side processing you will need to do the following: a) open the
“Channel Routing” window; b) assign the mid/side pair “MS1” to channels “A” and
“B”; c) assign channel “A” to group 1, channel “B” to group 2. After this has been
done, the mid channel will be affected by settings defined in the group 1, and the side
channel will be affected by settings defined in the group 2. Alternatively, you may
simply load the “Mid-Side Stereo” routing preset that will setup the necessary routing
for you.
38
Voxengo Primary User Guide
Q. I cannot get the GUI scale function to work. Tried closing and
reopening the GUI but this didn’t have any effect.
A. For the change to take effect when changing the user interface scale, you'll need to
reload your audio host application completely.
Q. I do not seem to find the “register” icon for the plug-in that allows me
to authorize the plug-in by entering the product key.
A. Latest Voxengo plug-ins are registered inside plug-in's user interface. Please open
plug-in’s “Settings” window – you'll see the “Enter Key” button there.
Q. If I click on the frequency, say “2K” and enter a “3” then it will jump to
“20.00” and never come back.
A. Please make sure you are entering “3K” instead of just “3”, because entering “3”
means “3 Hertz” – not “3 kilo Hertz”.
Q. It seems that the plug-in is taking some CPU resources even if I disable
all of its stages (modules).
A. This is to be expected since even if plug-in processes nothing it still performs some
routine tasks that are considered to be plug-in’s processing overhead. Plug-in may
also take additional CPU resources if its user interface is open since level meters (and
spectrums) have to be updated even in the absence of the signal. Also the
oversampling (quality) setting higher than “1x” alone makes plug-in take more CPU
resources.
Q. Why the output signal metering of the plug-in looks inconsistent with
the levels I see on my audio host application’s level meters?
A. This can be caused by three reasons: 1) If you are using mid-side processing the
output level you see is actually mid or side channel level, it is not a final output level.
This could not be implemented in a different manner because if plug-in showed only
the final output signal level you would not be able to see the signal level of the mid or
side channel separately. 2) If you are using the oversampling setting different from
the “1x”, the signal level you see is the output signal level before the final
downsampling is performed. Since after downsampling new peak overshoots may
appear you may see these peaks on the host’s level meter while not on the plug-in’s
one. However, these overshoots usually have a low magnitude and should not cause
any problems. If in doubt, please use a peak limiter on the master bus. 3) Audio host
39
Voxengo Primary User Guide
application's level meter integration time is different to plug-in's one. You can adjust
integration time of plug-in's level meters in the “Settings” window.
Q. I can only see one stereo out on the plug-in, that's not right, is it?
A. This means that your audio host application does not support VST 2.3 multi-
channel operation, or you are inserting this plug-in to a mono or stereo track/bus.
Many audio hosts still limit plug-in support to 2 channels input/output only, however
this is not plug-in’s limitation as it was successfully tested in hosts that support multi-
channel operation.
40
Voxengo Primary User Guide
on a stereo group. I then go into plug-in’s routing and Mute the B side-
chain signal as I do not want to hear it but it does not seem to be effecting
the compression.
A. In this scenario beside muting the “B side-chain signal” you also need to set key
signal source for channel “A”: it should be the “B” you have muted.
Q. Will upgrading to the latest plug-in version affect the settings for songs
already in progress where previous version is being used?
A. If you are applying a minor version update (e.g. 2.0 to 2.1, 3.0 to 3.2, etc.) this will
not affect settings, and the update can be considered “transparent”. Major version
upgrades will not interfere with your existing song settings since major version
upgrades come with a different module name and they can be used side-by-side with
a previous major version of the plug-in. However, next major version will not
automatically “inherit” settings and presets you created in the previous plug-in
version as, technically speaking, such next major version should be perceived as a
brand new plug-in. Next major version plug-in may also feature reworked sound
algorithms that may not sound exactly like a previous version at similar settings.
41
Voxengo Primary User Guide
Q. Is there anyway to change the default setting, the way the plug-in
loads? I would like to set some specific parameters every time I first
launch the plug-in.
A. Please use the “Set as Default” function in plug-in's own Preset Manager to set a
new default plug-in state.
Q. I’m testing Voxengo plug-in for “bit transparency”, and it seems that
even in the “Bypass” mode most plug-ins produce output with 32-bit
floating point resolution from 16-bit input signal. I was expecting them
to produce original 16-bit signal.
A. This is to be expected since the “Bypass” mode in Voxengo plug-ins should be
considered temporary-use mode. Even when in the “Bypass” mode Voxengo plug-ins
still add noise that prevents “denormal number” problem from happening. Since this
noise is very quiet, it increases technical bit depth of the signal. You may disable the
“Anti-Denormal Noise” option in the global settings to make plug-ins behave “bit-
transparently” in the “Bypass” mode.
Q. How can I get -48 (-96) dB per octave low- and high-pass filters?
A. All you need to do is add as many -24 dB per octave filters as necessary, all tuned
to the same center frequency. For additional convenience, you may put each filter to
its own Gain value so that you can have a single-click access to every filter. Do not
forget that you can also select all filters in order to move them together.
42
Voxengo Primary User Guide
Q. I'm not sure whether it is a bug or not but should the Underlay
spectrum follow the same Block size as the Main spectrum? Currently,
no matter which Block size I set, the Underlay spectrum block always
stays at 2048.
A. You have to copy spectrum mode settings from the current group to the underlay
group – this can be done by opening the Spectrum Mode Editor and using the “Copy”
function there.
Q. I’m now evaluating one of the Voxengo equalizers, and I was hitting
upon some strange behavior when using it. I used two “Peaking” filters
with a Gain setting of about -3dB and a rather wide bandwidth. What I’ve
got is that with the equalizer “on”, the track’s peak level was higher than
with the equalizer “off”. I do not get this.
A. All filters usually produce additional oscillation (known as Gibbs phenomenon),
thus increasing momentary peak levels while the average power of the signal may
become lower. This fact should not be considered as flaw, it is how mathematical side
of signal processing “works”.
Q. I have a constant amplitude “swept sine wave” file that I use for testing
purposes that sweeps from 20Hz to 20KHz over a period of 10 seconds.
When I play this file in my DAW (Cubase 6) the meters show a steady
amplitude from start to finish. When viewed in Voxengo spectrum
analyzer, however, the display is “flat” out to about 2KHz then starts
dropping off with a linear slope, meanwhile the meters show constant
amplitude. Why isn't the spectrum display “flat”?
A. Voxengo spectrum analyzers use FFT analysis which analyses blocks of audio that
are constant in length (e.g. 2048 samples). The blocked nature of analysis produces
an “increasingly averaging” effect over higher-frequency spectrum data hence the
higher frequencies show up as dampened. This is an unavoidable behavior, which
shows up on such dynamic “swept sine wave” signal, but which is absent when you
analyze constant tones.
43