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 Walkthrough

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

  1. To open the Audio Test Bench, at the MATLAB® command prompt, enter:

    audioTestBench

  2. In the Object Under Test box, enter audiopluginexample.Strobe and press Enter. The Audio Test Bench automatically displays the tunable parameters of the audiopluginexample.Strobe audio plugin.

    The mapping between the tunable parameters of your object and the UI widgets on the Audio Test Bench is determined by audioPluginInterface and audioPluginParameter in the class definition of your object.

  3. In the Object Under Test box, enter audiopluginexample.DampedVolumeController and press Enter. The Audio Test Bench automatically displays the tunable parameters of the audiopluginexample.DampedVolumeController audio plugin.

Run Audio Test Bench

To run the Audio Test Bench for your plugin with default settings, click . Move the sliders to modify the Gain (dB) and Transition Delay (s) 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 at line 63 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 (s) slider on the UI. To quit debugging, remove the breakpoint. In the MATLAB editor, click Quit Debugging.

Open Scopes

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:

  1. Select Audio File Reader.

  2. Click to open a UI for Audio File Reader configuration.

    You can enter any file name included on the MATLAB path. To specify a file that is not on that MATLAB path, specify the full file path.

  3. In the Name of audio file from which to read box, enter: RockDrums-44p1-stereo-11secs.mp3

Press Enter, and then exit the Audio File Reader configuration UI. 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:

  1. Choose to output to device and file by selecting Both from the Output menu.

  2. To open a UI for Audio Device Writer and Audio File Writer configuration, click .

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 Gain and TransitionDelay properties with MIDI controls you choose. Click OK.

See configureMIDI for more information.

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 UI sliders. Your processed audio file is saved to the current folder.

Validate and Generate Audio Plugin

To open the validation and generation dialog box, click .

You can validate only, or validate and generate your MATLAB audio plugin code in VST 2 plugin format. The Generate a 32-bit audio plugin check box is available only on win64 machines. See validateAudioPlugin and generateAudioPlugin for more information.

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.

See Also

Apps

Functions

Classes

Related Topics

Was this topic helpful?