Table Of Content
Introduction
Blue Cat's StereoScope Pro is a real time stereo field analyzer with multiple views and MIDI/automation output capabilities. It is a powerful help to analyze how the audio signal is spread in the stereo field, and you can easily detect potential phase and mono compatibilities issues.
The stereo analysis can be controlled in details, and the precise measurements capabilities combined with the zoomable displays let you monitor what is exactly happening.
Choose your preferred view for your needs: real time stereo field display, evolution of the stereo image over time (2D or 3D) or output parameters that explicitly describe the average position and extent of the audio signal in the stereo field. The 3D waterfall view lets you see in details from your preferred viewpoint the evolution of the stereo image over time.
The four memory slots let you store any curve in memory: it helps you make comparisons between several tracks or effects setup very easily. You can compare your mix with other commercial hits!
Like our other professional analysis tools, the output parameters of this plug-in can be used to control other effects in real time: the generated automation envelopes or MIDI CC messages include the minimum and maximum positions in the stereo field and the perceived position based on the audio energy spread in the stereo image. Check the DP Meter Pro Tutorials to see how to use this capability within your favorite host.
Thanks to Blue Cat's skinning language support and the included window opacity management feature, you can adapt the plug-in user interface to your personal needs and enhance your workflow: work faster and more efficiently.
For multiple tracks stereo analysis, you want to give a try to Blue Cat's StereoScope Multi plugin.
System Requirements
MacOS
- An Intel or Apple Silicon processor.
- Mac OS 10.9 or newer.
- Any VST / Audio Unit / AAX compatible application (64-bit) .
Windows
- An SSE2-enabled processor (Pentium 4 or newer).
- Microsoft Windows Vista, Windows 7, 8 or 10.
- Any VST / AAX compatible host software (32 or 64 bit).
For more information about supported platforms, see our Knowledge Base.
Demo Limitations:
- One single instance of the plug-in per session.
- The plug-in is frozen for 4 seconds every 40 seconds.
Installation
The plug-ins versions cannot be run standalone: they require a host application (see the System Requirements chapter for more information). Depending on which host application you use, you might need to install the plug-ins in different locations.
Before installing one of the plug-in versions, you should close all your host applications.
Windows
Install
All versions of the plug-in provide an installation program. Follow the steps of the wizard to install the software on your machine. During the installation you will be asked where you want the software to be installed. For the VST version, you should install the plug-in inside the VST plug-ins folder used by your host application(s). The default path set in the installer should work for most applications, but you should check your host software documentation to know where it looks for VST plug-ins. For other plug-in types, you should just use the standard path.
Some applications will not automatically rescan the new plug-ins, so you might have to force a refresh of the plug-ins list.
Upgrade
When a new version of the software is released, just launch the new installer: it will update the current installation.
Uninstall
To uninstall the software, simply launch the "Uninstall" program that is available in the start menu or in the configuration panel. It will take care of removing all files from your computer.
Mac
Install
On Mac the plug-ins are available as drive images with an installer. After download, double click on the dmg file to open it. You can then double click on the installer (.pkg file) to install the package.
Note for Mac OS 10.15 Catalina or newer: you may have to right click on the installer and select "Open" instead of double clicking on the file to launch the installation if your computer is not connected to the Internet.
Upgrade
When a new version of the software is released, just launch the new installer: it will update the current installation.
Uninstall
To uninstall the software, simply remove the component(s) from their install location (move them to the trash):
- AAX plug-ins are installed in the /Library/Application Support/Avid/Audio/Plug-Ins/ folder
- Audio Units (AU) are installed in the /Library/Audio/Plug-Ins/Components/ folder
- RTAS Plug-ins are installed in the /Library/Application Support/Digidesign/Plug-Ins/ folder
- VST plug-ins are installed in the /Library/Audio/Plug-Ins/VST folder
- VST3 plug-ins are installed in the /Library/Audio/Plug-Ins/VST3 folder
If you want to completely remove all settings and configuration files, you can also remove these additional directories that may have been created on your computer:
- ~/Library/Preferences/Blue Cat Audio/[Plug-in name and TYPE], where TYPE is VST, AU, RTAS or AAX: global preferences.
- ~/Library/Preferences/Blue Cat Audio/[Plug-in name]: license information
- ~/Documents/Blue Cat Audio/[Plug-in name]: user data, such as presets, additional skins and user-created plug-in data.
Please be aware that these directories may contain user data that you have created. Remove these directories only if you do not want to reuse this data later.
First Launch
Blue Cat Audio plug-ins cannot be run standalone, they require a host application (see the System Requirements chapter for more information). Some host applications will require you to scan the plug-ins before they are available in the application.
If the plug-in is not available in the application, please check that it has been installed in the appropriate directory (with no host application running), and that the host application has scanned it.
Using Blue Cat's StereoScope Pro
The User Interface
Note: The main toolbar, menus and basic features available with all our plug-ins are detailed in the Blue Cat Audio Plug-ins Basics section.
Overview
The plug-in's user interface is composed of three panels:
- The stereo view where you can see the instant, average and peak stereo image of the audio signal in real time.
- The 'stereogram' view showing the evolution of the stereo image over time.
- The output view where you can monitor and control the output parameters generation.
- The main toolbar area: load presets, freeze GUI, adjust settings (more details in next chapter).
- Choose the view to display.
- The current view (more details for each type of view below).
- The controls displayed at the bottom of the user interface let you modify the parameters for the audio analysis. This controls pane can be collapsed to gain real estate on the screen ("Show Controls" button in the toolbar).
Stereo View
This view displays a graph representing the stereo image of the input audio signal. Note that all the content displayed in the red area of the screen (extreme left and right) is out of phase content that will cancel each other if you sum both channels to mono.
- Select the curves to display on the screen: you can choose the “instant” curve or the “peak” cusrve (maximum over time) or “average” curve (averaged over time).
- The four “A B C D” buttons let you store the curve to one of the proposed memory slots. The curves stored into these slots can be shown/hidden with the buttons available in (3).
- Show/Hide curves stored in memory. Click on the arrow below to save or load them as files or copy/paste them thru the system clipboard (the curves format is compatible with the StereoScope Multi plug-in.
- pposition and stero spread values. These values reflect the average position and the spreading of the signal in the stereo field. More information about these parameters can be found in the parameters section later in this manual.
- These two sliders let you control the x and y zoom for the graph. When the zoom factor is greater than one, you can drag the graph with the mouse (click on the graph when the cursor is a small hand and drag to move in the graph).
- This meter shows the value of the center, minimum and maximum position output parameters. It lets you visualize the instant stereo width and energy center at a glance.
- Choose to display filled curves or single curves. If your graphics adapter is old and you encounter display performance issue you might want to uncheck this option.
- Position of the mouse cursor on the display.
- Correlation meter. This shows the correlation of the left and right audio signals. More information about this parameter can be found in the parameters section later in this manual.
- Rulers can be dragged with the mouse when the graph has been zoomed. They display the scales for the x and y axis.
The coordinates of the graph below the mouse pointer are displayed at the top of the screen. The display can be zoomed with the mouse selecting an area of the screen (or using the mouse wheel):
Once zoomed you can drag the display with the mouse on the ruler areas.
Stereogram View
This view displays the evolution of the stereo image over time. Two modes are available: 2D display with precise measurement capabilities or 3D waterfall display.
2D Mode
In 2D mode, the stereo image is represented as a 2D color plot, the color representing the value of the signal for a given position at a given time. In the default color scheme, the closer to red the louder, and the closer to dark blue, the quieter.
- Choose between 2D mode (this display mode) or 3D waterfall mode.
- Two functions are available for the mouse on the graph view: either drag the graph when zoomed or display the coordinates of the pointer and value of the stereogram and zoom by selecting an area of the screen.
- Choose to display either the “instant” curve or the “peak” curve (maximum over time).
- These two sliders let you control the x and y zoom for the graph. When the zoom factor is greater than one, you can drag the graph with the mouse (click on the graph when the cursor is a small hand and drag to move in the graph).
- Rulers can be dragged with the mouse when the graph has been zoomed. They display the scales for the x and y axis.
3D Waterfall Mode
In 3D mode, the stereo image is represented as a 3D surface with the same color scale as the 2D plot.
This 3D "stereogram" view lets you move the 3D graph within the screen so that you can choose your favorite viewpoint. Please note that the measurement tool is not enabled in this mode.
You can use the following controls for 3D movement:
- Mouse drag: rotate the object.
- Hold Ctrl key and mouse drag: translate the object.
- Rotate mouse wheel: zoom / unzoom (you can hold the shift key for higher precision).
- Mouse right click: reset position to default (as shown above).
It is still possible to use the zooming capability offered by the two sliders on the top left corner of the view. It will have the same effect as in the 2D view: zooming either the time axis or the stereo position axis. Note that when the surface has been rotated, these two axis may not be in the same direction as the sliders anymore.
Output View
This view shows the evolution of output parameters over time and lets you control the transform applied to these parameters for automation and MIDI outputs.
- Controls to modify the output envelopes: reverse, amount and offset. They let you customize the values generated for the transformed output parameters.
- These graphs show the evolution of the transformed output parameters values over time for each channel. They represent the center and width of the stereo image above the thresholds.
The various elements of the user interface (knobs, sliders, buttons...) are simple and intuitive to operate, but more information about how to interact with them is available in the "Plug-ins Basics" chapter of this manual.
Operation
This plug-in allows you to visualize the repartition in the stereo field of the audio signal and also to generate MIDI CC messages or automation curves based on the measurements made by the plugin. The illustration below shows the principle of this system.
Stereo Field Visualization
There are many situations where you need to be able to vizualize the stereo repartition of the the signal, when your ears are not enough (bad monitoring, ear fatigue, subtle stereo issue that requires visual confirmation, mono compatibility check). This is the main purpose of the StereoScope Pro plugin: it provides visual assistance for what your ears cannot detect. It is also a convenient way of comparing your audio tracks with reference material, as shown in this tutorial (shows spectrum comparison but it is also applicable to stereo measurements).
The analysis can be fine tuned in details to exactly fit your needs. This chapter describe in details how you can tweak the analysis:
Tweak the precision
It is possible to tweak the precision of the analyzer: the higher the "presision" parameter, the more points are computed to draw the stereo field curve.
Please note that the higher the precision, the higher CPU consumption.
Customize the time response
The attack and release times control how fast the analyzer respectively responds to audio amplitude increase or decrease. For example, when pushing both parameters to their maximum the instant curve will become a local average of the audio stereo field representation.
The "Max Reset" speed control how fast the maximum curve is reset to the instant curve. This lets you tweak the max curve so that it follows the instant curve or shows the absolute maximum value of the signal.
Adjusting the response
Thanks to the gain control, the curve can be tweaked when the incoming audio signal is too loud or too quiet and the curve does not fit in the screen. The gain is applied at the input of the analyzer but does not modify the signal at the output of the plugin.
Threshold controls
In order to isolate the loudest parts of the signal and to control how the min and max positions are computed, it is possible to set an absolute as well as a relative threshold on the curve. If the signal is below the threshold (absolute value for the absolute thresold - for example 0.5, or value relative to the maximum value - for example 30% of the maximum value in the current curve) it is reset to the minimum value.
Interpreting Measurements
Principles
The main points of interest are the shape of the stereo field curve, the correlation value and the position of the energy center (or "center" position). They help you understand how "stereo" and balanced the audio signal is.
- Correlation value: when close to 1 the signals are highly correlated (mono signal). When the value is close to 0 both signals are not correlated. It means they have nothing in common. It can be the case when left and right channels are different instruments playing different parts. When the value reaches -1, both signal are negatively correlated. It means that when summed to mono they will cancel each other. You usually want the correlation value to stay above 0 to avoid phase cancellation issues.
- Center position ("energy center"): it represents the overall perceived position of the sound in the stereo field. If highly negative (close to -100%), the sound is panned to the left, and if it is highly positive (+100%), the sound is perceived as panned to the right. You usually want this value to oscillate closely around the center. Note that if it moves too fast with a wide amplitude, it might make the listener sick.
- Curve shape: it shows the repartition of the audio amplitude in the stereo field. Everything above 100% and below -100% in the stereo field is out of phase signal that will be cancelled when summing to mono. See the examples below for typical shapes.
Examples
Below is a typical example of a mono signal centered in the stereo field: correlation is equal to 1 (left and right signals are exactly the same), and the curve shows a single spike in the center of the screen.
Below is a typical display for an out of phase signal that will produce a very low mono output (almost silent in this case). Note the correlation close to -1 and the peaks that appears in the extreme left and right parts of the screen:
Finally, a typical commercial track will have in average more content in the center and a continuously decreasing amplitude on the left and rights of the stereo field. You can also note that most peaks will appear in the center of the stereo field (as shown by the peak curve). Correlation is typically in the middle between 0 and 1, showing a good stereo perception without mono compatibility issue. The energy center is oscillating around the center of the stereo field, showing a good left/right balance.
Envelopes Generation
Thanks to this unique capability, you can create unique side chain effects controlled by the stereo content of the audio signal. The idea is to measure the minimum and maximum positions as well as the balance of the incoming audio and reuse them as controller values for other effects. The exact response for these values can be customized in the "output" pane of the user interface. Special controls for MIDI and automation generation are available in the settings window of the plugin.
For more information about how to use this capability in your favorite host application, see our Digital Peak Meter Pro tutorials page: this plugin has a similar MIDI CC and automation output capability. The Blue Cat's StereoScope Pro Tutorials will give you some more ideas about what to use the generated envelopes for.
Blue Cat Audio Plug-Ins Basics
This chapter describes the basic features that are common to all our plug-ins. If you are already familiar with our products, you can skip this part.
User Interface Basics
About Skins
Like all Blue Cat Audio plug-ins, Blue Cat's StereoScope Pro uses a skinnable user interface. It means that the appearance and behavior of the user interface can be entirely customized.
Especially with third party skins, the experience may be quite different from the one offered by the default skins that we provide. However, our plug-ins and our skinning engine have several standard features that will be available whatever your favorite skin.
More information about custom skins can be found in the skins section.
The Main Toolbar
In most skins, an optional toolbar at the top of the user interface gives you access to the main options and settings of the plug-in:
Smooth Bypass
On the left, the power button can be used to smoothly bypass the plug-in.
Presets Area
At the center of the toolbar, you can see the current preset area (the "Default Settings" box). It displays the name of the current preset, with a "*" at the end if it has been modified since loaded.
The arrows on the left and right let you navigate thru the (factory and user) presets available for the plug-in.
Clicking on the preset name opens the presets menu which lets you manage the presets of the plug-in.
Using the knob on the bottom right of this area, you can reduce the opacity of the window, and make it transparent (the actual result may depend on the host application). Additional messages may appear in the area next to this knob, depending on the plug-in.
Some plug-ins may also propose you to manually select the audio I/O inside the plug-in (bottom left of the presets area), regardless of the host configuration. It can be useful for example to save CPU by selecting mono to stereo configurations (instead of full stereo sometimes chosen by default by the host), or add extra channels to manage side chain internally, when the host does not provides any side chain input. Please note that this does not change the number of I/O seen by the host application.
Commands
The icons in the toolbar give you access the to the following commands that are detailed in the next paragraph:
| Icon | Name | Function |
|---|---|---|
 |
Menu | Open the main menu |
 |
Control Settings | Display the controls settings menu (to manage automation and MIDI control, as described here). |
 |
Undo | Undo |
 |
Redo | Redo |
 |
Manual | User Manual |
 |
About | About |
 |
Zoom | Scale the user interface (from 70% to 200%). |
The Main Menu
The main menu is available from the main toolbar, or if you right click anywhere on the background of the plug-in:
- Presets: opens the presets menu to manage presets.
- Preset Skin: opens the skins menu to choose the skin for the current preset and manage alternative skins for the software.
- Undo/Redo: undo or redo the latest modifications. This includes all changes made to the current preset settings such as MIDI or automation preferences.
- Presets Settings: open the presets settings window. It lets you change the skin, MIDI and automation settings for the current preset.
- Global Settings: open the global settings window. It lets you change the skin, MIDI and automation settings that are used by default in all instances of the plug-in (if not overridden by the current preset).
- User Manual: open this user manual.
- Check for Updates: opens up our website to let you check if any update for this software is available.
- Get More Skins: get more skins for this software.
- Legal Information: browse licensing and misc legal documents.
- About: displays the “about” dialog box.
Controls
Examples
Here are a few examples of typical controls you will encounter in the user interface of our plug-ins:
| slider | slider | knob | button | Text control |
 |
 |
 |
 |
 |
Interacting with Controls
You can interact with the controls of the plug-in interface either with the mouse or the keyboard.
Setting the keyboard focus on a control (so that it responds to key strokes) may be automatic (when you pass the mouse over it it gets focus) or manual (you have to click on the control to set the focus on it). Note that all host applications behave differently regarding keyboard handling. In some applications you may not be able to use all keys described later in this manual to interact with our plug-ins. It is usually made obvious to you to know the active surfaces of the skin (the places where you can click with the mouse): the mouse cursor usually changes when you can do something on a control. In the default skins delivered with the plug-in, the cursor changes to a small hand or an arrow to tell you when your mouse is over an active control.
Mouse
Various mouse movements will let you interact with the controls:
| Mouse Interaction | Action |
|---|---|
| Left Click | Acquire focus and start dragging or push (button) |
| Left Click + Alt Key | Set the value to default |
| Left Double Click |
Acquire focus and launch the “fine
tuning” edit box (except button):
 |
| Right Click | Set the value to default |
| Mouse Wheel | Increment or decrement the position (focus required) |
| Mouse Drag | Change the control position depending on mouse movement (except button) |
Keyboard
All control widgets support the following keys (note that some of them are caught by the host and thus never forwarded to the control. For example in Steinberg Cubase SX you cannot use the arrow keys to control the plug-in):
Keys Common to All Controls
| Key | Action |
|---|---|
| Up Arrow | Small increment of the position (up or right) |
| Down Arrow | Small increment of the position (down or left) |
| Left Arrow | Same as Down Arrow |
| Right Arrow | Same as Up Arrow |
| Page Up | Large increment of the position (up or right) |
| Page Down | Large decrement of the position (down or left) |
| + | Small increment of the value of the control |
| - | Small decrement of the value of the control |
| d | Set to default value (same as mouse right click) |
| e |
Opens the 'fine tuning' window to precisely
set the parameter:
|
| SHIFT | When the key is down, the fine tuning mode is on, and you can modify the value with better precision when moving the mouse, the mouse wheel or using the keyboard. Just release the key to get back to the normal mode. |
Keys Specific to Buttons
| Key | Action |
|---|---|
| Enter | Pushes the button |
Presets
To get started with the plug-in and discover its capabilities, a couple of factory presets are provided. You can also save your own presets and recall them later for other projects. Our plug-ins propose a full-featured preset manager to let you save, browse, organize and recall its presets.
The Presets Menu
The presets menu can be opened from the main menu or the main toolbar. It displays the list of presets available for the plug-in as well as commands to load, save or organize presets:
- Factory Presets: shows the list of factory presets delivered with the plug-in.
- "Folder A" to "User Preset Z": user presets and categories.
- MIDI Program Change: activate MIDI Program Change support (see below).
- Load: load preset from file.
- Save: save current state to last loaded user preset.
- Save As: save current preset to a file.
- Copy copy preset to the system clipboard.
- Paste paste preset from the system clipboard, if available.
- Save As User Default: save the current state as the default preset. This preset is used every time a new instance of the plug-in is created.
- Clear User Default: reset the default preset to its factory state: this makes the plug-in forgets the custom settings you might have saved as a default preset.
More about Presets
There are two types of presets: factory presets (read only) that are provided with the plug-in, and user presets that can be created and stored by the user.
The user presets are stored in a subdirectory of the documents folders of your profile ("Documents" on Mac, and "My Documents" on Windows): Blue Cat Audio/[Plug-in Name]/Presets. Each preset is stored as an individual file. You can create folders and subfolders in the Presets directory to classify your presets, as shown in the example below:
If you save a preset named "Default" in the root Presets directory, it will override the factory default preset (that's what "Save As Default" does). To restore the factory default preset, you can just remove this file or use the "Reset Default" command.
MIDI Program Change
It is possible to load presets remotely using MIDI "Bank Select" and "Program Change" messages. To enable this feature, select a MIDI channel to receive the events from in the MIDI Program Change menu item from the presets menu:
This setting is saved for each plug-in istance with your session but not in presets (except for the default preset, using the "Save as User Default command"). Once activated, the plug-in menu will display the bank number followed by the preset number for each preset:
Every root folder is considered as a new bank, starting with the factory presets (bank 0). Program and bank numbers may change while you add folders and presets, so you should be careful when naming them if bank and program numbers matter to you. It is recommended to use folders to make this task simpler. As a side note, sub folders do not define additional banks (all presets contained in sub folders are associated with the current bank.
As specified by MIDI, bank select messages are not used until a program is actually selected.
MIDI Implementation note: the software supports all types of Bank Select methods. You can use either MIDI CC 0 or MIDI CC 32 to select banks. If both are used simultaneously, they are combined together so that you can use more banks (in this case CC0 is LSB and CC32 is MSB, and actual bank number is 128*CC0+CC32).
MIDI and Automation Control
Blue Cat's StereoScope Pro can also be remotely controlled via MIDI using MIDI CC ("Control Change") messages or automation curves, if your host application supports it. It is possible to customize the channel, control numbers, range and response curve used for each parameter in the settings panel available from the main menu (see the Plug-in Settings chapter for more details).
MIDI and Automation Settings Menu
The main menu
Most skins also provide the ability to change MIDI and automation settings directly in the main user interface. Clicking on the control settings icon in the main toolbar opens the following menu:
- Show Control Settings: show direct access to individual control settings for each parameter in the user interface (see next paragraph).
- Lock Control Settings: lock the current controls settings for MIDI and automation so that they remain unchanged when loading presets.
- Use Global Control Settings: ignore the current MIDI/automation settings and use the global settings instead.
- Control Settings Window: display the control settings window, to change control settings for all parameters.
- Save As Global Control Settings: save the current settings as global settings (used by default, when no specific MIDI/Automation setting has been set for the cuirrent preset).
Individual Control Settings
When this feature is activated using the "Show Control Settings" item in the MIDI and Automation Settings menu, dropdown menu buttons appears next to the main controls displayed by the plug-in:
Clicking on this button shows the MIDI/Automation settings menu:
- MIDI Learn: launches MIDI learn mode for the control: touch your MIDI controller and the control will learn from it the MIDI channel and CC number. To end the learn mode, reopen this menu and deselect the option.
- MIDI Unlearn: deactivates MIDI control for this parameter.
- Control Settings: launches the advanced settings panel described below. This controls the settings for the current preset.
- All Control Settings: display the control settings window, with access to all parameters.
Advanced MIDI and Automation Settings
You can completely customize the way the plug-in is controlled by automation and MIDI. For a global view of all parameters at a time, you can use the Plug-in Settings window for the current preset which is available from the main menu.
MIDI Settings:
- Enable MIDI: enable/disable the MIDI control of the parameter.
- Channel: MIDI Channel for the parameter control. If set to 0, the plug-ins will accept Control Change Messages from all MIDI Channels (MIDI Omni mode).
- CC: Control Change Number.
- Learn: click on this button to activate the MIDI learn functionality. When it is activated, you can move your MIDI controller, and the plug-in will automatically set the MIDI Channel and CC Number.
MIDI and automation settings:
- Response: response curve of the MIDI or automation control: from very fast to slow control.
- Min: minimal value of the parameter when MIDI controlled or automated.
- Max: Maximum value of the parameter when MIDI controlled or automated.
Note: if the Min value is higher than the Max value, the response curve will be reversed: increasing the control value will decrease the parameter value.
Note: if you double click on the parameter text control boxes for the max and min values, a “fine tuning” edit box will appear and let you change the min and max values with more precision:
MIDI and Automation Output
Blue Cat's StereoScope Pro can also generate MIDI CC Events or automation curves thanks to its output parameters.
You have access to the same settings for the output parameters as you have for input parameters using the dropdown menu, except that you can also enable or disable automation.
The output parameters MIDI and Automation Menu:
The advanced output parameters MIDI and Automation settings window:
More
Check our online tutorial for more screenshots and more examples of our plug-ins user interfaces.
Blue Cat's StereoScope Pro Parameters
All parameters described below can be automated and controlled via MIDI if your host application supports it. You can precisely define this behavior in the settings panels described later in this manual.
Input
|
Param id |
Name |
Unit |
Description |
|---|---|---|---|
|
General |
|||
|
dsp.input0 |
Bypass |
|
Bypass the effect. |
|
dsp.input1 |
Precision |
% |
Precision of the stereo field analysis. The higher the setting, the higher the resolution, and the higher the CPU consumption |
|
dsp.input2 |
Attack |
ms |
Attack time for the stereo image envelope follower. |
|
dsp.input3 |
Release |
ms |
Release time for the stereo image envelope follower. |
|
dsp.input4 |
Peak Reset |
Hz |
Rate of the peak curve reset. If set to 0, the peaks will never decrease and will represent the maximum value. |
|
dsp.input5 |
Abs Threshold |
|
Absolute threshold for stereo image display. The values below this threshold are set to 0 |
|
dsp.input6 |
Rel threshold |
% |
Relative threshold for stereo image display (percentage of the maximum value). The value below this threshold are set to 0) |
|
dsp.input7 |
Gain |
dB |
Gain applied to the audio signal before the analysis takes place. Can be useful when analyzing signals with low levels. |
|
dsp.input8 |
Reset Peak |
|
Command to reset peak curves (value changes are considered as reset commands) |
|
dsp.input9 |
Reset Average |
|
Command to reset average curves (value changes are considered as reset commands) |
|
Output Transformation |
|||
|
dsp.input10 |
Position Reverse |
|
Reverse the transformed position envelope. |
|
dsp.input11 |
Position Amount |
% |
Amount for the transformed position envelope. |
|
dsp.input12 |
Position Offset |
% |
Offset for the transformed position envelope. |
|
dsp.input13 |
Min Position Reverse |
|
Reverse the transformed min position envelope. |
|
dsp.input14 |
Min Position Amount |
% |
Amount for the transformed min position envelope. |
|
dsp.input15 |
Min Position Offset |
% |
Offset for the transformed min position envelope. |
|
dsp.input16 |
Max Position Reverse |
|
Reverse the transformed max position envelope. |
|
dsp.input17 |
Max Position Amount |
% |
Amount for the transformed max position envelope. |
|
dsp.input18 |
Max Position Offset |
% |
Offset for the transformed max position envelope. |
|
dsp.input10 |
Pan Law |
|
Specify the pan law for the stereo field analysis. This lets you match the values that can be read on the x-axis of the graph with the pan pots of your digital audio workstation. P-Cosine: projected cosine law (corresponds to a sine-cosine pan law projected from a circle to a linear axis) / Cosine: sine-cosine pan law / Linear. |
Output
The plug-in also provides output parameters for automation or MIDI CC generation (see below).
Note that positions in the stereo field are expressed as values between -1.5 and 1.5. Negative values represent positions on the left side and positive values represent positions on the right side. The [-1;1] range is heard between the speakers and positions outside this range are for out of phase signals that are heard outside the speakers.
|
Param id |
Name |
Unit |
Description |
|---|---|---|---|
|
General |
|||
|
dsp.output0 |
Position |
|
Position of the audio signal (computed as the stereo image energy center). Similar to “balance”. |
|
dsp.output1 |
Min Position |
|
Minimum position of the stereo image above thresholds. |
|
dsp.output2 |
Max Position |
|
Maximum Position of the stereo image above thresholds. |
|
dsp.output6 |
Correlation |
|
Correlation of the left and right audio signals. When close to 1 the signals are highly correlated (mono signal). When the value is close to 0 both signals are not correlated. It means they have nothing in common. It can be the case when left and right channels are different instruments playing different parts. When the value reaches -1, both signal are negatively correlated. It means that when summed to mono they will cancel each other. You usually want the correlation value to stay above 0 to avoid phase cancellation issues. |
|
Transformed |
|||
|
dsp.output3 |
Transformed Position |
|
Position with transform applied. |
|
dsp.output4 |
Min Position |
|
Min position with transform applied. |
|
dsp.output5 |
Max Position |
|
Max position with transform applied. |
Blue Cat's StereoScope Pro Curves
The StereoScope Pro plug-in provides visual feedback about the stereo image of the audio signal thanks to output curves. The stereo content curves represent the intensity of the audio signal (value between 0 and 1) according to the position in the stereo field (value between -1.5 and 1.5, see the explanation in the previous chapter).
|
Curve id |
Name |
Description |
|---|---|---|
|
dsp.output_curve0 |
Instant Stereo Image |
Instant stereo content of the audio signal. |
|
dsp.output_curve1 |
Peak Stereo image |
Maximum value of the stereo image over time. |
|
dsp.output_curve2 |
Average Stereo Image |
Average value of the stereo image over time. |
Plug-in Settings
In addition to the controls offered in the main user interface, Blue Cat's StereoScope Pro has various settings that let you fine tune the behavior of the plug-in. You can choose to change these settings either for the current preset or globally for all instances of the plug-in.
The Global Settings Window
The settings available in this window apply to all instances of the plug-in, for all presets, if not overridden in the presets settings. Consider these settings as “default” settings.
General
You can change the default skin for all instances of the plug-in: write the skin file path in the text edit box or click on the button to open a file chooser dialog. If you have several instances of the plug-in opened in your session, you will have to re-open the user interfaces of these plug-ins to see the skin change.
The output data refresh rate can also be customized for all instances of the plug-in. It controls the refresh rate of non-audio data produced by the plug-in (parameters, curves...). It also controls the refresh rate of output MIDI CC messages or output automation data. The higher the refresh rate, the better precision, but also the higher cpu usage (some host applications may also have trouble recording MIDI data at high refresh rates). The default value is 50 Hz.
Global Control Input Settings (MIDI and Automation)
The plug-in offers a couple of settings that affect the way it is controlled by MIDI messages or automation. While the first settings only apply to MIDI control, the "Control Response", "Min" and "Max" settings apply to both automation and MIDI control.
For each parameter you can define a default MIDI channel and CC number. You can then control the plug-in with an external MIDI controller or one of our plug-ins that generate MIDI messages.
The settings below are available for each plug-in parameter.
MIDI Settings:
- Enable MIDI: enable/disable the MIDI control of the parameter.
- Channel: MIDI Channel for the parameter control. If set to 0, the plug-ins will accept Control Change Messages from all MIDI Channels (MIDI Omni mode).
- CC: Control Change Number.
- Learn: click on this button to activate the MIDI learn functionality. When it is activated, you can move your MIDI controller, and the plug-in will automatically set the MIDI Channel and CC Number.
MIDI and automation settings:
- Response: response curve of the MIDI or automation control: from very fast to slow control.
- Min: minimal value of the parameter when MIDI controlled or automated.
- Max: Maximum value of the parameter when MIDI controlled or automated.
Note: if the Min value is higher than the Max value, the response curve will be reversed: increasing the control value will decrease the parameter value.
Note: if you double click on the parameter text control boxes for the max and min values, a “fine tuning” edit box will appear and let you change the min and max values with more precision:
"Send MIDI events when parameters values change": activate this option when using a control surface that accepts MIDI events as input. MIDI messages will be sent to the output of the plug-in when the user change the parameters values in the user interface, to keep the software and the controller in sync. MIDI is only sent for parameters that are activated for MIDI control.
Global Control Output Settings (MIDI and Automation)
You can set the same properties for the output parameters as for the input parameters: in this case, they may trigger MIDI CC messages or generate automation curves when modified. Since it's output, you cannot set the channel to MIDI Omni, so you must choose a channel.
Output parameters can also generate automation curves in most host applications. You can enable automation for any output parameters you are interested in (see the "Enable Autom." checkbox).
Note: if the Min value is higher than the Max value, the response curve will be reversed: increasing the control value will decrease the parameter value.
Note: if you double click on the parameter text control boxes for the max and min values, a “fine tuning” edit box will appear and let you change the min and max values with more precision:
The Current Preset Settings Window
In this window you can change the settings for the current preset of the current instance of the plug-in only.
Preset Skin
You can choose to use the global skin setting or to change the skin for the current preset. This way you can have different skins for different instances of the plug-in in the same session in order to differentiate them.
Preset Control Input Settings (MIDI and Automation)
Use the global settings or override them for the current preset. The parameters are the same as for the global input settings.
Preset Control Output Settings (MIDI and Automation)
Use the global settings or override them for the current preset. The parameters are the same as for the global output settings.
About Skins
Blue Cat's StereoScope Pro integrates Blue Cat's skinning engine that allows you to customize the user interface. You can download alternate skins for your plug-in at the following address:
If you don't find a skin that fits your need or if you want a custom one, you can choose to create your own skin.
Choosing the Skin
There are two ways to select the skin of your plug-in: you can change the default (or 'global') skin, or change the skin for the current preset only (either in the preset settings page or from the main menu). The global skin applies to all plug-in instances (choose this one if you want to use the skin used by default, regardless of the session or preset), whereas the current preset skin only applies to the current preset of the current plug-in instance (use this one if you want to change only the skin for the current session/preset).
Note: in some host applications, the plug-in window won't resize automatically when you choose a skin with a different size. In this case, just close the window and re-open it: it will be displayed with the right size.
The Skins Menu
The skins menu can be opened from the main menu. It displays the list of skins available for the plug-in as well as commands to manage the skin used by default when no preset skin has been selected:
- First Section - Factory Skins: shows the list of factory skins delivered with the plug-in ("Default" and "Light" in this example).
- Second Section - User Skins: shows the list of user skins that have been installed in the Documents Skins folder for the plug-in (see below).
- Use Global Skin: use the global skin for the current preset/session (unloads any custom skin previously selected for the current preset).
- Load: opens a file browser dialog to manually select the skin from the file system.
- Save As Global Skin: use the current preset skin as the global skin (loaded by default if no preset skin has been defined).
Installing User Skins
To select user skins directly from the skins menu, install them in the "Skins" directory available in the plug-in's documents folder:
[Your Documents Folder]/Blue Cat Audio/[Plugin Name]/Skins/
The skin engine will scan this folder for new skins (xml files) and display them in the menu. The skin files should be in the root skins folder or in a subdirectory inside this folder: subdirectories are not scanned recursively.
Other Methods to Select Skins
You can also select the skins in the settings panels available from the main menu:
The global skin (used by default if no preset skin has been selected) can be changed in the global settings pane. The current preset skin can be changed in the preset settings page .
Create a Custom Skin
You can create custom skins for your plug-in in order to adapt it to your exact needs. You can change its look and feel and make it completely integrated in your virtual studio!
Just read the Blue Cat's Skinning Language manual and download the samples for the tutorial on http://www.bluecataudio.com/Skins. You can get ready to create your own skins in a few minutes. You can then share your skins on our website.
More...
This manual only covers the main aspects of Blue Cat's StereoScope Pro. Our website offers many additional resources for your Blue Cat's StereoScope Pro plug-in. It is constantly updated, so keep an eye on it!
Updates
As you can see in the history log below, we care about constantly updating our products in order to give you the latest technology available. Please visit our website often to check if Blue Cat's StereoScope Pro has been updated, or subscribe to our Newsletter to be informed of the latest news about our products.
Note: minor version updates are available from the same location as the original full version download (link received by email upon purchase). The demo version publicly available on our website will not let you register.
You can also follow us on twitter, facebook and instagram for almost real time updates notification, and subscribe to our YouTube channel to watch the latest videos about our software.
Versions History
Thanks again for choosing our software!
See you soon on www.bluecataudio.com!