tapoutput.dsp

Tap accumulated DSP output.

Function

This instrument permits reading the accumulated stereo output from all currently running output instruments (e.g. directout.dsp, mixerNxN.dsp). These signals are what is eventually sent to the audio DACs.

This can be used to snoop the audio output of an application without the application being aware of it (real handy for debugging!).

It can also be used to provide instrumentation, and such, for the accumulated audio output of the DSP (see examples).

Outputs

LeftOutput

RightOutput

Resources

Ticks: 6

Code: 6 words

Implementation

V24

Examples

Combine with delaystereo.dsp to capture the output of an application to memory without the cooperation of the application (kind of like a screen grabber for audio).

Combine with a pair of envfollower.dsp instruments and a pair of Probes to make stereo VU meters for the accumulated audio of all applications currently running.

Combine with a pair of envfollower.dsp instruments, a pair of maximum.dsp instruments, and a pair of Probes to make a stereo peak level detector for the accumulated audio of all applications currently running.

Notes

You should only use this instrument when there's no direct way to get the signals you want. For example, if you want to add metering or peak detection to your own application (as opposed to every application that is running on the 3DO at a given time), split your audio (e.g. the output of a submixer), between directout.dsp and envfollowers instead of using tapoutput.dsp.

This instrument must be allocated at a lower priority than all the output instruments that you want to snoop. If not, you'll only get the accumulated results of all of the output instruments at higher (and perhaps equal) priority to tapoutput.dsp. Allocate at a priority of 0 to get the accumulated results of most output instruments.

See Also

directout.dsp, delaystereo.dsp, envfollower.dsp, maximum.dsp, examples/capture_audio.c examples/minmax_audio.c