From 1935d47c3d000e437250c16ebe0b23b8cd4519e5 Mon Sep 17 00:00:00 2001 From: Stan Seibert <volsung@xiph.org> Date: Fri, 12 Mar 2004 03:37:46 +0000 Subject: [PATCH] Clean up ALSA driver descriptions. git-svn-id: http://svn.xiph.org/trunk/ao@5934 0101bb08-14d6-0310-b084-bc0e0c8e3800 --- doc/drivers.html | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/drivers.html b/doc/drivers.html index adfe7ee..c6e8e25 100644 --- a/doc/drivers.html +++ b/doc/drivers.html @@ -44,13 +44,13 @@ when the device is closed. The option value is ignored. <h3>alsa</h3> Advanced Linux Sound Architecture. This driver borrows some code from -Jaroslav Kysela's <perex@suse.cz> GPLed aplay that is included with +Jaroslav Kysela's <perex@suse.cz> 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. +it to the card. Note that this driver only works with ALSA 0.5.x. +You should use the <tt>alsa09</tt> driver for the ALSA 0.9.x or 1.0.x +series. <p> <b>Option keys:</b> @@ -66,15 +66,16 @@ Experiment with this if the sound skips. Default is 32768. <h3>alsa09</h3> -Advanced Linux Sound Architecture, version 0.9.x API. This is -essentially the alsa driver modified to use the newer API. +Advanced Linux Sound Architecture, version 0.9.x and 1.0.x API. This +is essentially the alsa driver modified to use the newer API. <p> <b>Option keys:</b> <ul> <li>"dev" - Device name of sound card. Defaults to "default". -<li>"buf_size" - Override the internal buffer size (in bytes). -Experiment with this if the sound skips. Default is 32768. +<li>"buf_time" - Override the hardward buffer size (in milliseconds). +<li>"period_time" - Override the size of periods ALSA uses. +<li>"use_mmap" - Set to "1" to enable the use of memory-mapped I/O API. </ul> <p> @@ -217,7 +218,7 @@ The ranking system currently used is: <center> <table border="1"> <tr><th>Priority</th><th>Drivers</th> </tr> - <tr><td>30</td> <td>alsa</td> </tr> + <tr><td>30</td> <td>alsa, alsa09</td> </tr> <tr><td>20</td> <td>oss, irix, sun</td> </tr> <tr><td>10</td> <td>esd,arts</td> </tr> <tr bgcolor="#888888"><td> 0</td> <td>null, all file output</td></tr> -- GitLab