Debug, test, and tune audio plugin
The Audio Test Bench provides a graphical interface through which
you can develop, debug, test, and tune your audio plugin in real time. You can interact
with properties of your audio plugin using associated parameter graphical widgets. See audioPluginParameter
for more
information.
Using the Audio Test Bench, you can:
Debug your audio plugin.
Simulate your audio plugin as generated in a digital audio workstation (DAW).
Visualize your processing with time-domain and frequency-domain scopes.
Interactively synchronize MIDI controls to plugin properties.
Run validation checks and generate VST plugins.
Button | Description | |
---|---|---|
![]() | Run | Run your audio plugin in an audio stream loop using the specified input and output configuration. You can tune parameters of your audio processing algorithm in real time. The MATLAB® command line and objects used by the test bench are locked while the test bench is running. |
![]() | Pause (appears while test bench runs) | Pause audio stream loop. The MATLAB command line is released. Objects used by the test bench remain locked. |
![]() | Step Forward | Call the processing function of your audio plugin one time in an audio stream loop, with input and output specified by your input and output configuration. |
![]() | Stop | Stop the audio stream loop. The MATLAB command line and objects used by the test bench are released. |
![]() | Reset | Reset internal states of your audio plugin and set parameters to their initial values. |
![]() | View Source Code | Open the source file of your audio plugin. |
![]() | Synchronize to MIDI Controls | Start the configureMIDI user
interface (UI) for your plugin object. |
![]() | Open the visualizer of the object under test | Call the See the
|
![]() | Time Scope | Open an instance of dsp.TimeScope , which
provides a time-domain visualization of the output from your audio
stream loop. |
![]() | Spectrum Analyzer | Open an instance of dsp.SpectrumAnalyzer ,
which provides a frequency-domain visualization of the output from
your audio stream loop. |
![]() | Generate VST 2 Audio Plugin | Open a UI to validate and generate your plugin object. For Audio Toolbox™ System objects, the Audio Test Bench
creates an audioPlugin class using the
createAudioPluginClass method of the object.
The created plugin class is used to generate a plugin object. For
more information, see validateAudioPlugin , generateAudioPlugin ,
and the createAudioPluginClass method of your System
object™. |
![]() | Generate MATLAB Script | Generate a MATLAB script implementation of your audio test bench. |
![]() | Help | Open MATLAB documentation for Audio Test Bench. |
![]() | Configure Input | Open the input configuration UI. The UI options depend on your choice of input to the audio stream loop. See the corresponding documentation for your input choice:
|
![]() | Configure Output | Open the output configuration UI. The UI options depend on
whether you choose Audio File Writer or
Audio Device Writer for the output
from your audio stream loop. If you choose to output
Both , two dialog boxes open: one for
the Audio File Writer and one for the
Audio Device Writer . For more
information, see dsp.AudioFileWriter and audioDeviceWriter . |
MATLAB command prompt: Enter audioTestBench
.
audioTestBench pluginClass
audioTestBench
opens the
Audio Test Bench for an instance of pluginClass
pluginClass
.
The input to audioTestBench
must derive from the audioPlugin
class, not the audioPluginSource
class.
audioTestBench(pluginClassInstance
)
audioTestBench(
opens the Audio Test Bench for pluginClassInstance
)pluginClassInstance
,
where pluginClassInstance
is an instance of an audio plugin
class. The input to audioTestBench
must derive from the audioPlugin
class, not the audioPluginSource
class.
audioTestBench ASTSystemObject
audioTestBench
opens the
Audio Test Bench for an instance of a compatible Audio Toolbox
System
object.ASTSystemObject
audioTestBench(ASTSystemObjectInstance
)
audioTestBench(
opens the Audio Test Bench for
ASTSystemObjectInstance
)ASTSystemObjectInstance
, where
ASTSystemObjectInstance
is an instance of a compatible Audio Toolbox
System
object.
audioTestBench(hostedPlugin
)
audioTestBench(
opens the
Audio Test Bench for hostedPlugin
)hostedPlugin
, where
hostedPlugin
is an object returned by the loadAudioPlugin
function.
audioTestBench(pluginPath
)
audioTestBench(
opens the
Audio Test Bench for pluginPath
)pluginPath
, where
pluginPath
is the location of an external plugin. Use the
full path to specify the audio plugin you want to host. If the plugin is located in
the current folder, specify it by its name.
The Audio Test Bench provides persistent input and output settings across sessions.
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.