audiere::AudioDevice Class Reference

#include <audiere.h>

List of all members.

Public Member Functions
virtual void ADR_CALL	update ()=0
virtual OutputStream *ADR_CALL	openStream (SampleSource *source)=0
virtual OutputStream *ADR_CALL	openBuffer (void *samples, int frame_count, int channel_count, int sample_rate, SampleFormat sample_format)=0
virtual const char *ADR_CALL	getName ()=0

---

Detailed Description

AudioDevice represents a device on the system which is capable of opening and mixing multiple output streams. In Windows, DirectSound is such a device.

This interface is synchronized. update() and openStream() may be called on different threads.

---

Member Function Documentation

virtual const char* ADR_CALL audiere::AudioDevice::getName (   )  [pure virtual]

Gets the name of the audio device. For example "directsound" or "oss". Returns: name of audio device

virtual OutputStream* ADR_CALL audiere::AudioDevice::openBuffer (  void *  samples, int  frame_count, int  channel_count, int  sample_rate, SampleFormat  sample_format )  [pure virtual]

Open a single buffer with the specified PCM data. This is sometimes more efficient than streaming and works on a larger variety of audio devices. In some implementations, this may download the audio data to the sound card's memory itself. Parameters: samples  Buffer containing sample data. openBuffer() does not take ownership of the memory. The application is responsible for freeing it. There must be at least |frame_count * channel_count * GetSampleSize(sample_format)| bytes in the buffer. frame_count  Number of frames in the buffer. channel_count  Number of audio channels. 1 = mono, 2 = stereo. sample_rate  Number of samples per second. sample_format  Format of samples in buffer. Returns: new output stream if successful, 0 if failure

virtual OutputStream* ADR_CALL audiere::AudioDevice::openStream (  SampleSource *  source  )  [pure virtual]

Open an output stream with a given sample source. If the sample source ever runs out of data, the output stream automatically stops itself. The output stream takes ownership of the sample source, even if opening the output stream fails (in which case the source is immediately deleted). Parameters: source  the source used to feed the output stream with samples Returns: new output stream if successful, 0 if failure

virtual void ADR_CALL audiere::AudioDevice::update (   )  [pure virtual]

Tell the device to do any internal state updates. Some devices update on an internal thread. If that is the case, this method does nothing.

---

The documentation for this class was generated from the following file:

• D:/CVS/twgui/twgui/source/include/audiere.h

---