Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

Audio Test Bench

Debug, test, and tune audio plugin

Description

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.

Develop and Test Features

ButtonDescription
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 ForwardCall 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.
StopStop the audio stream loop. The MATLAB command line and objects used by the test bench are released.
ResetReset internal states of your audio plugin and set parameters to their initial values.
View Source CodeOpen the source file of your audio plugin.
Synchronize to MIDI ControlsStart the configureMIDI user interface (UI) for your plugin object.
Time ScopeOpen an instance of dsp.TimeScope, which provides a time-domain visualization of the output from your audio stream loop.
Spectrum AnalyzerOpen an instance of dsp.SpectrumAnalyzer, which provides a frequency-domain visualization of the output from your audio stream loop.
Generate VST 2 Audio PluginOpen a UI to validate and generate your plugin object. For Audio System 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 ScriptGenerate a MATLAB script implementation of your audio test bench.
HelpOpen 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 OutputOpen 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.

Open the Audio Test Bench App

MATLAB command prompt: Enter audioTestBench.

Examples

Related Examples

Programmatic Use

expand all

audioTestBench pluginClass opens the Audio Test Bench for an instance of pluginClass. The input to audioTestBench must derive from the audioPlugin class, not the audioPluginSource class.

audioTestBench(pluginClassInstance) opens the Audio Test Bench for 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 opens the Audio Test Bench for an instance of a compatible Audio System Toolbox System object.

audioTestBench(ASTSystemObjectInstance) opens the Audio Test Bench for ASTSystemObjectInstance, where ASTSystemObjectInstance is an instance of a compatible Audio System Toolbox System object.

audioTestBench(hostedPlugin) opens the Audio Test Bench for hostedPlugin, where hostedPlugin is an object returned by the loadAudioPlugin function.

audioTestBench(pluginPath) opens the Audio Test Bench for 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.

Introduced in R2016a

Was this topic helpful?