WaveWarp 2.0 Component
      
MATLAB:
Functional Description
Real-time processing performed in the MATLAB workspace on audio data streaming from/to WaveWarp
on a frame-by-frame basis (with a user-adjustable frame-size, set via the "Communication" button).
The data is manipulated by MATLAB 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 INPUT variable:" dialog |
Enter any valid MATLAB variable name under which the raw signal from WaveWarp is sent to the
MATLAB workspace.
|
| "Name of OUTPUT variable:" dialog |
Enter any valid MATLAB variable name for the output (i.e. processed) signal in the MATLAB
workspace which is then sent
back to WaveWarp (if the "Pause data transfer" and "Bypass" buttons are not activated).
|
| "Pause data transfer" button |
Toggles the activation state of the MATLAB in-the-loop process. If "Pause" is selected,
the transmission of data from WaveWarp to MATLAB is stopped. The MATLAB variables
will retain the values they held at the point in time
at which the button was pressed. The
WaveWarp output will retain the value it held at the point in time
at which the button was pressed, whilst respecting the "Signal gain" setting.
In all events, the "Mute" state is respected.
| "Enter desired MATLAB code..." dialog |
Enter any valid MATLAB code to define the process acting on the input signal
to yield the output signal (if the "Pause data transfer" and "Bypass" buttons are not activated).
The MATLAB code can make use of any pre-existing workspace variables
(in addition to the input and output variables). Likewise, any m-functions, scripts, or mex functions
may be used.
|
| "Signal gain" slider and dialogs | Scales
the overall amplitude of the signal returning 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 in WaveWarp to zero (the MATLAB variables are unaffected).
|
| "Bypass" button | If selected,
the WaveWarp output signal is made identically equal to the input signal, whilst
respecting the "Mute" state (the "Signal gain" setting is ignored).
|
|
Algorithm
N/A
Signal Implementations
| Audio signals | Control signals | Description |
|---|
| Single input single output mono-mono | n/a | MATLAB effect (acting on a single column vector) applied to mono input, sent to mono output |
| Single input single output mono-stereo | n/a | MATLAB effect (acting on a double column matrix) applied to mono input with flexibility for separate treatment (i.e. column-wise) for left and right stereo output channels |
| Single input single output stereo-mono | n/a | MATLAB effect (acting on a double column matrix) applied with flexibility for separate treatment (i.e. column-wise) for left and right stereo input channels, then averaged and sent to mono output |
| Single input single output stereo-stereo | n/a | MATLAB effect (acting on a double column matrix) applied with flexibility for separate treatment (i.e. column-wise) for left and right stereo output channels, respectively |
Related components:
Example DrawingBoards illustrating usage:
|
