WaveWarp 2.0 Component
      
MATLAB:
Functional Description
Real-time streaming of audio data from the MATLAB workspace to WaveWarp.
The data is sent frame-by-frame (with a user-adjustable frame-size, set via the "Communication" button).
An optional transformation can be invoked whereby each frame of data is manipulated
(before being sent to WaveWarp) according to an arbitrary user-defined MATLAB script evaluated
in the workspace using any combination of variables present in the workspace.
NOTE: This component requires MATLAB (v5.3 or later), available separately from The MathWorks, Inc. (www.mathworks.com)
| Parameter | Purpose |
|---|
| "Name of raw signal:" dialog |
Enter any valid MATLAB variable name under which the raw signal from the MATLAB
workspace is sent to WaveWarp (if the "Enable transform" button is not activated).
|
| "Name of transformed signal:" dialog |
Enter any valid MATLAB variable name under which the transformed signal from the MATLAB
workspace is sent to WaveWarp (if the "Enable transform" button is activated).
|
| "Enable transform" button |
Toggles the activation state of the (optional) data transform function.
| "Enter desired MATLAB code..." dialog |
Enter any valid MATLAB code to define the (optional) transform function acting on the raw signal
to yield the transformed signal (if the "Enable transform" button is pressed).
The MATLAB code can make use of any pre-existing workspace variables (in addition to the raw and
transformed variables). Likewise, any m-functions, scripts, or mex functions
may be used.
|
| "Signal gain" slider and dialogs | Scales
the overall amplitude of the signal after being sent to WaveWarp (the MATLAB variables are unaffected).
The gain can be set via the slider or either of the linear or decibel data entry dialogs. Although
the slider has pre-defined limiting values,
these can be overwritten by any arbitrary value entered in either of the dialogs. |
| "Mute" button | If selected, sets
the amplitude of the output signal to zero after being sent to WaveWarp
(the MATLAB variables are unaffected).
|
| "Bypass" button | If selected,
stops the transmission of data from MATLAB to WaveWarp and de-activates the transformation
process in the MATLAB workspace. The MATLAB variables and WaveWarp output will
retain
their values from the point in time at which "Bypass" was selected (though the WaveWarp output
will continue to respect the "Mute" state and the "Signal gain" setting).
|
|
Algorithm
N/A
Signal Implementations
| Audio signals | Control signals | Description |
|---|
| No input mono output | n/a | MATLAB workspace variable (single column vector) sent to mono WaveWarp output |
| No input stereo output | n/a | MATLAB workspace variable (double column matrix) sent to stereo WaveWarp output, one column per channel |
Related components:
Example DrawingBoards illustrating usage:
|
