Develop, Analyze, and Debug Plugins In Audio Test Bench
In this tutorial, explore key functionality of the Audio Test Bench. The Audio Test Bench app enables you to debug, visualize, and configure audio plugins.
Choose Object Under Test
To open the Audio Test Bench, at the MATLAB® command prompt, enter this command.
In the Object Under Test box, enter
audiopluginexample.Strobeand press Enter. The Audio Test Bench automatically displays the tunable parameters of the
The mapping between the tunable parameters of your object and the UI widgets on the Audio Test Bench is determined by
audioPluginParameterin the class definition of your object.
In the Object Under Test box, enter
audiopluginexample.DampedVolumeControllerand press Enter. The Audio Test Bench automatically displays the tunable parameters of the
Run Audio Test Bench
To run the Audio Test Bench for your plugin with default settings, click . Move the sliders to modify the Gain and Transition Delay parameters while streaming.
To stop the audio stream loop, click . The MATLAB command line and objects used by the test bench are now released.
To reset internal states of your audio plugin and return the sliders to their initial positions, click .
Click to run the Audio Test Bench again.
Debug Source Code of Audio Plugin
To pause the Audio Test Bench, click .
To open the source file of your audio plugin, click .
You can inspect the source code of your audio plugin, set breakpoints on it, and
modify the code. Set a breakpoint in the
function and then click on the Audio Test Bench.
The Audio Test Bench runs your plugin until it reaches the breakpoint. To reach the breakpoint, move the Transition Delay slider. To quit debugging, remove the breakpoint. In the MATLAB editor, click Quit Debugging.
To open a time scope to visualize the time-domain input and output for your audio plugin, click . To open a spectrum analyzer to visualize the frequency-domain input and output, click .
To release objects and stop the audio stream loop, click .
Configure Input to Audio Test Bench
The Input list contains these options:
Audio Device Reader option is not
supported in MATLAB
Audio File Reader.
Click to open a dialog box for
Audio File Readerconfiguration.
You can enter any file name included on the MATLAB path. To specify a file that is not on the MATLAB path, specify the full file path.
In the Audio file box, enter:
Press Enter, and then exit the
Reader configuration dialog. To run the audio test bench with your
new input, click .
To release your output object and stop the audio stream loop, click .
Configure Output from Audio Test Bench
The Output list contains these options:
Audio Device Writer––
Audio File Writer––
None–– The audio signal is not routed to a file or device. Use this option if you are only interested in using the visualization and tuning capabilities of the test bench.
Audio Device Writer and
Both options are not supported in MATLAB
Choose to output to device and file by selecting
Bothfrom the Output menu.
To open a dialog for
Audio Device Writerand
Audio File Writerconfiguration, click .
Call Custom Visualization of Audio Plugin
If your audio plugin has a custom visualization method, the button appears on the Audio Test
Bench. In the Object Under Test box, enter
audiopluginexample.VarSlopeBandpassFilter and press
Enter. To open the custom visualization of
audiopluginexample.VarSlopeBandpassFilter, click . The custom visualization plots the frequency
response of the filter. Tune the plugin parameters and observe the plot update in
Custom visualizations are available only in MATLAB and not in generated plugins.
Synchronize Plugin Property with MIDI Control
If you have a MIDI device connected to your computer, you can synchronize plugin
properties with MIDI controls. To open a MIDI configuration UI, click . Synchronize the
HighCutoff properties with MIDI controls you choose. Click
configureMIDI for more
Play the Audio and Save the Output File
To run your audio plugin, click . Adjust your plugin properties in real time using your synchronized MIDI controls and sliders. Your processed audio file is saved to the current folder.
Audio playback is not supported in MATLAB Online.
Validate and Generate Audio Plugin
To open the validation and generation dialog box, click .
You can validate your MATLAB audio plugin code and generate audio plugin binaries. In the
Coder configuration section, you can specify libraries for
deep learning and code replacement when generating plugins. See
audioPluginConfig for more information.
Plugin generation is not supported in MATLAB Online.
Generate MATLAB Script
To generate a MATLAB script that implements a test bench for your audio plugin, click .
You can modify the code for complete control over the test bench environment, including the ability to create processing chains by placing plugins in cascade.