WaveWarp Users' Guide: last updated 28 February 2002

2.28-- Automated DrawingBoard Conversions

For convenience, WaveWarp has a suite of built-in "automated converters" which enable you to instantly convert a given DrawingBoard into another type. For example, a DrawingBoard configured to play an input WAV file via an output soundcard can be converted to a live input processor, whereby the input WAV file is replaced by an input soundcard component, without having to perform any dragging-and-connecting.

The DrawingBoard converters are accessed via the "Convert DrawingBoard to" option under the File menu (or by right-clicking on a given DrawingBoard). This will open up the complete list of possible conversions, as illustrated in the screenshot in Figure 21. Note that there is a choice of mono and stereo for each conversion option.

Figure 21 DrawingBoard automated conversion options.

When performing the auto-conversions involving inputs and outputs, the only "relevant" I/O components i.e. those which are potentially affected by the conversion, are listed as follows: input and output WAV files , input and output audio ASCII files, input and output Wave devices, input and output DirectX ports. No other I/O components are affected by the conversions (e.g. signal generators, oscilloscopes, etc). Table 2 summarises all the available conversions and the specific actions they perform.

Table 2 DrawingBoard auto-conversion options

DrawingBoard conversion option	Result of conversion
WAV File Play	Converts all relevant inputs into WAV files; converts the first relevant output into an output Wave device; leaves all other outputs as they were but disconnects them.
WAV File to WAV File	Converts all relevant inputs and outputs into WAV files, retaining all connections.
DirectX Plugin (two-way)	Converts first relevant input into a DirectX Input port, leaves all others as they were; converts first relevant output into a DirectX Output port, leaving all others as they were; retains all connections.
DirectX Plugin (one-way) Input Only	Converts first relevant input into a DirectX Input port, leaving all others as they were; doesn't alter any outputs; retains all connections.
DirectX Plugin (one-way) Output Only	Doesn't alter any inputs; converts first relevant output into a DirectX Output port, leaving all others as they were; retains all connections.
Live Play	Converts first relevant input into a live input Wave device; converts the first relevant output into an output Wave device; leaves all other outputs as they were but disconnects them.
Live WAV File Record	Converts first relevant input into a live input Wave device; converts all outputs into WAV files, retaining all connections.
Live ASCII File Record	Converts first relevant input into a live input Wave device; converts all outputs into audio ASCII files, retaining all connections.
ASCII File Play	Converts all relevant inputs into audio ASCII files; converts first relevant output into output Wave device; leaves all other outputs as they were but disconnects them.
ASCII File to WAV File	Converts all relevant inputs into audio ASCII files; converts all relevant outputs into WAV files, retaining all connections.
ASCII File to ASCII File	Converts all relevant inputs and outputs into audio ASCII files, retaining all connections.
Mono of the same	Converts all components into their mono equivalent.
Stereo of the same	Converts all components into their stereo equivalent.

To avoid possible overwriting of the original DrawingBoard, the auto-converted DrawingBoard is automatically given a new name with a unique identifier (e.g. "DirectX" ) prepended to the original name.

Note: whenever you select a DrawingBoard via the DirectX interface (discussed in section 3--) the required "DirectX Plugin (two-way)" conversion is automatically performed so that you never need to worry about whether or not your DrawingBoard has any DirectX ports.