wavplay
a C library to play wave audio files
| Author: | Zhihao Yuan <[email protected]> |
|---|---|
| Date: | 2011-11-02 |
| Copyright: | 2-clause BSD License |
| Version: | 0.4 |
| Manual section: | 3 |
SYNOPSIS
#include "wavplay.h"wav_play(const char * filename);wav_send(FILE * stream);snd_init(void);snd_end(void);snd_drop(void);DESCRIPTION
The snd_init() initializes the sound device. Until the snd_end() function is called or the program is quit, the device reminds open. The snd_drop() function stops the device from playing.
The wav_play() function opens and plays a wave audio file, and the wav_send() function plays a wave audio data stream. The sound device will be set according to the sampling format.
If the macro USE_ALSA is defined, ALSA is used instead of OSS as the backend. The default OSS device is /dev/dsp, and the default ALSA PCM name is default. They are defined by the macro DEV_NAME.
RETURN VALUES
The snd_init(), snd_end(), and snd_drop() functions return a non-negative integer if successful. The actual value is different for OSS/ALSA.
The wav_play() and wav_send() functions return the value 0 if the sound data was sent to the device; otherwise the value -1 is returned.
SUPPORTED FORMATS
WAV (+extensible), AIFF/AIFC (+sowt), Sun Au, with 8/16/24/32 bits PCM or A-law, mu-law audios, are fully supported. IMA ADPCM in WAV or AIFF is also supported. The playback support depends on the OSS/ALSA drivers and the soundcard.