WaveWarp 2.0 Component
      

Output Audio Files:
Functional Description
Represents an 8-, 16-, 20-, 24-, or 32-bit, linearly-coded, mono or stereo WAV file as an output
destination for an audio signal. The Output Audio Files category of the Component Library includes the filenames of
all such files located in the user-specified directory on the hard-disk. Any file in the list can be used as an
audio output on the DrawingBoard. However, all connected output files are over-written when the DrawingBoard is
played so they should be used with caution. For convenience, and to avoid unintentional over-writing, a set of
"place-holder" template output files are always available (regardless of the user-specified directory).
These template files are listed in the following table:
| Filename | Description |
| New8mono.wav | Empty 8-bit mono WAV file |
| New8ster.wav | Empty 8-bit stereo WAV file |
| New16mon.wav | Empty 16-bit mono WAV file |
| New16ste.wav | Empty 16-bit stereo WAV file |
| New20mon.wav | Empty 20-bit mono WAV file |
| New20ste.wav | Empty 20-bit stereo WAV file |
| New24mon.wav | Empty 24-bit mono WAV file |
| New24ste.wav | Empty 24-bit stereo WAV file |
| New32mon.wav | Empty 32-bit mono WAV file |
| New32ste.wav | Empty 32-bit stereo WAV file |
These files can be used on the DrawingBoard as if they were standard (i.e. non-empty) WAV files. When data
has been written to any such file (i.e. after playing the DrawingBoard), it is advisable to change its
name so as to preserve the recorded data as well as to preserve the "place-holder" name for
new files. The name of any file on the DrawingBoard can be changed by double-clicking on its filename.
This will open a conventional "Save As" file dialog box which can then be used to rename the file in the usual "Windows" manner.
Multiple copies of the same output file are not permitted on a
DrawingBoard, though the same output file can appear on any number of DrawingBoards simultaneously.
An output WAV file can be written with any sample rate, and multiple output files with different
sample rates can be written simultaneously on a DrawingBoard, as long as the rules of connectivity
for multiple sample rates are adhered to (see the WaveWarp Users' Guide for more information.)
When the DrawingBoard is played, the audio data going to a given output WAV file is converted from
WaveWarp's internal floating-point representation (nominally over the range -1 to +1) into the integer
representation corresponding to the bit-resolution of the WAV file (8-, 16-, 20-, 24-, or 32-bit).
It is at this point that digital clipping can occur, usually with undesirable consequences.
To avoid clipping, the signal levels throughout the DrawingBoard must be adjusted such that the
amplitude of the signal reaching the output WAV file is within the range -1 to +1. This is entirely the
responsibility of the user since WaveWarp's
flexible architecture offers complete freedom when manipulating signal levels. The Audio Limiter and Audio
Normaliser components in the Dynamic Range Controllers category of the Component Library are useful for
helping to avoid clipping. The Decibel Audio LED component in the Displays and Scopes category of the
Component Library is a useful diagnostic tool for checking if clipping has occurred.
Note for
MATLAB®
users:
the "wwmatlab" sub-directory of the WaveWarp root directory contains
the necessary function m-files (plus example scripts) for reading and writing WAV files from
within MATLAB, thus enabling the user to directly manipulate the individual samples of a WAV file off-line,
and, furthermore, to create a WAV file from any sequence of numerical values.
Algorithm
n/a
Signal Implementations
| Audio signals | Control signals | Description |
| Single input mono | n/a | Writes data to a 8-, 16-, 20-, 24-, or 32-bit mono WAV file |
| Single input stereo | n/a | Writes data to a 8-, 16-, 20-, 24-, or 32-bit stereo WAV file |
Related components:
Example DrawingBoards illustrating usage:

      
|