WaveWarp Users' Guide: last updated 28 February 2002

WaveWarp Audio Toolbox for MATLAB® Users' Guide Addendum (Software Version 2.0.4)

© COPYRIGHT 1998-2002 by Sounds Logical. All rights reserved.

The software described in this document is furnished under a license agreement. The software may be used only under the terms of this agreement.

WaveWarp, WaveWarp DrawingBoard, WaveWarp Audio Toolbox, the Sounds Logical logo, and the WaveWarp logo are trademarks of Sounds Logical. Portions of the WaveWarp software are ©1997-1999 Massachusetts Institute of Technology, used under license by Sounds Logical.

Microsoft, MS, MS-DOS, Windows, Windows 95, Windows 98, Windows ME, Windows NT, Windows 2000, and Windows XP are either registered trademarks or trademarks of Microsoft Corporation.

MATLAB is a registered trademark of The MathWorks, Inc.

Other product or brand names are trademarks or registered trademarks of their respective holders.

TABLE OF CONTENTS

1-- WELCOME 5

1.1-- System requirements 5

1.2-- Installation 6

2-- USING THE WAVEWARP AUDIO TOOLBOX FOR MATLAB ® 7

2.1-- Getting started 7

2.2-- MATLAB-enabled WaveWarp Components 7

2.2.1-- Summary of available components 7

2.2.2-- Using the MATLAB-enabled WaveWarp components 8

2.2.3-- Managing "window clutter" when using WaveWarp and MATLAB 13

2.2.4-- User extensibility: simple "homemade" GUI example 14

2.3-- MATLAB m-files for "off-line" use with WaveWarp 15

2.4-- Known bugs and limitations 18

LIST OF FIGURES

Figure 1 Example Drawing Board containing a MATLAB-enabled WaveWarp component (in this case, a MATLAB Wave Player component). See Figure 2 for a view of the associated MATLAB GUI. 9

Figure 2 Example of a MATLAB GUI associated with a MATLAB-enabled WaveWarp component (in this case, the MATLAB Wave Player component from the Drawing Board in Figure 1). 10

Figure 3 WaveWarp-MATLAB inter-process communication window activated by clicking the "Communication" button on a MATLAB GUI. 11

Figure 4 Example "homemade" MATLAB GUI designed to interact with WaveWarp via the MATLAB workspace. 14

Figure 5 "MATLABtoControlExamplePiano.dwb" Example Drawing Board depicting a frequency-controlled oscillator under the command of a MATLAB workspace variable. 15

Figure 6 Setting the 'MATLAB-To-Control' component to utilize the "PianoNote" workspace variable as its output to WaveWarp. 15

LIST OF TABLES

Table 1 Summary of MATLAB-enabled WaveWarp components provided with the WaveWarp Audio Toolbox for MATLAB® 7

Table 2 List of MATLAB "window management" functions provided with WaveWarp 2.0.4 13

Table 2 List of MATLAB "off-line" function m-files bundled with WaveWarp 2.0.4 16

Table 3 List of "off-line" MATLAB script m-files bundled with WaveWarp 17

Table 4 Summary of known MATLAB-specific bugs and limitations in WaveWarp 2.0.4 18