====== capture_audio ======

Record the output from the DSPP to a host file.

==== Synopsis ====

''%%capture_audio [<num frames>] [<dest file>]%%''

==== Description ====

Captures the output from the DSP into a file on the development station's filesystem. It can be used to check the sound output of a program at important points.

Once the output from the DSP has been captured, you can load it into SoundHack and edit it as follows:

1. From the File menu in SoundHack, choose Open Any.

2. Select the file that was captured with capture_audio.

3. Use the Header Change command and set the captured file's header to a rate of 44100, with 2 channels, and a format of 16-bit Linear.

4. Select Save As command and save the sound file as a 16-bit AIFF format file.

You can then load the AIFF file you created and listen to the captured sounds.

==== Arguments ====

  * **num frames** Number of sample frames to capture. Defaults to 10000.

  * **dest file** Name of the file to save the captured frames to. Defaults to capture.raw.

==== Caveats ====

This program adds an instrument at priority 0. Because the execution order of equal priority instruments depends isn't as predictable as those of differing priority, this program may not be able to capture from other instruments at priority 0.

==== Associated Files ====

capture_audio.c

==== Location ====

examples/Audio