Sounds Logical
home

WaveWarp 2.0 Component

IndexCurrent GroupPrevious GroupNext GroupPrevious ComponentNext ComponentBottom of Page

Functional Description | Algorithm | Signal Implementations | Related Components | Example DWBs usage

Output Audio Files:

Output WAV file

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 monon/a Writes data to a 8-, 16-, 20-, 24-, or 32-bit mono WAV file
Single input stereon/a Writes data to a 8-, 16-, 20-, 24-, or 32-bit stereo WAV file
Related components:
  • None
Example DrawingBoards illustrating usage:

IndexCurrent GroupPrevious GroupNext GroupPrevious ComponentNext ComponentTop of Page

home - news - products - store - support - site map - company info
© 2007 Sounds Logical. All rights reserved.
Sounds Logical
legal notice - privacy statement