libao documentation

libao version 0.8.0 - 20010804

libao Drivers

Libao supports both live output drivers and file output drivers. Live output drivers send audio data to sound cards and sound daemons. File output drivers write audio to disk using a particular file format (such as WAV, AU, etc.). You must invoke the ao_open_????() function that corresponds to the type of driver you are using, but otherwise live and file drivers are treated identically in libao.

Live Output Drivers

null

Null driver. This is just a test device which does not write the audio data anywhere.

Option keys:


alsa

Advanced Linux Sound Architecture. This driver borrows some code from Jaroslav Kysela's GPLed aplay that is included with the alsa-util distribution. It defaults to device 0 on card 0. Because of the way ALSA reads data, this driver packs sound from successive calls into a fixed size buffer (defaults to 32kB) and sends it to the card. Note that this driver only works with ALSA 0.5.x. It will be updated to the newer API once it stabilizes and is better documented.

Option keys:


alsa09

Advanced Linux Sound Architecture, version 0.9.x API. This is essentially the alsa driver modified to use the newer API.

Option keys:


esd

ESounD audio driver. This sound daemon is used on some Linux systems. It permits multiple programs to play sound simultaneously and sound to be sent to networked computers.

Option keys:


irix

IRIX audio driver. This was inherited from the original libao, but has not been tested. Use at your own risk. (Better yet, fix it! I don't have access to an IRIX system.)

Option keys: None.


oss

Open Sound System driver. This is the audio system for Linux and FreeBSD as well as some other UNIX-like systems.

Option keys:


sun

Sun audio driver. This is the audio system for NetBSD, OpenBSD, and Solaris.

Option keys:


File Output Drivers

au

Sun audio file driver. Writes a .au file from audio output. This driver can write usable data to unseekable files (like standard out), which the wav driver cannot do.

Option keys: None.


raw

Raw sample driver. Writes the sound to disk in uncompressed, headerless form using the byte order specified.

Option keys:


wav

Windows sound file output. Because of the way WAV files are structured, this driver cannot correct files unless the target file is seekable. Writing WAVs to stdout will result in broken files. Use either the raw or the au driver instead.

Option keys: None.


Default Driver Detection

In the absence of
configuration files to explicit identify a default driver, the library will try to detect a suitable default driver. It does this by testing every available live output driver (using ao_plugin_test()) and finding the driver with the highest priority (see the ao_info struct) that works. Drivers with priority 0, such as the null and file output drivers, are never selected as the default.

The ranking system currently used is:

PriorityDrivers
30 alsa
20 oss, irix, sun
10 esd,arts
0 null, all file output

Clearly, any ranking scheme will fail to make everybody happy. For such cases, the configuration files can be easily used to define an appropriate default output device


copyright © 2001 Stan Seibert

xiph.org
indigo@aztec.asu.edu

libao documentation

libao version 0.8.0 - 20010804