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.

More

Develop and Test Features

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 visualize function of the object under test with no input arguments. If your object under test does not define a visualize function, then the button does not appear. See the audiopluginexample.VarSlopeBandpassFilter plugin for an example of how to define the visualize function.
	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: Audio File Reader –– dsp.AudioFileReader Audio Device Reader –– audioDeviceReader Audio Oscillator –– audioOscillator Wavetable Synthesizer –– wavetableSynthesizer Chirp Signal –– dsp.Chirp Colored Noise –– dsp.ColoredNoise
	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.

Open the Audio Test Bench App

MATLAB command prompt: Enter audioTestBench.

Examples

Related Examples

• Audio Test Bench Walkthrough

Programmatic Use

audioTestBench pluginClass

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)

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

audioTestBench ASTSystemObject opens the Audio Test Bench for an instance of a compatible Audio Toolbox System object.

audioTestBench(ASTSystemObjectInstance)

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

audioTestBench(hostedPlugin)

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

audioTestBench(pluginPath)

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.

Tips

• The Audio Test Bench provides persistent input and output settings across sessions.