Import from divmod. Added css. Original log message:

r1585 | casper | 2005-07-09 23:26:15 +0200 (Sat, 09 Jul 2005) | 3 lines

Last checkin before version 0.2





git-svn-id: svn://svn.code.sf.net/p/pyalsaaudio/code/trunk@12 ec2f30ec-7544-0410-870e-f70ca00c83f0

CHANGES

@@ -0,0 +1,8 @@
+VERSION 0.1
+- Initial version
+
+
+VERSION 0.2
+- Many bugfixes related to playback in particular
+- Module documentation in the doc subdirectory
+

LICENSE

@@ -0,0 +1,54 @@
+PyAlsaAudio is released under the same conditions as Python itself.
+The original wording of this license can be found below.
+
+
+PSF LICENSE AGREEMENT FOR PYTHON 2.4
+------------------------------------
+
+1. This LICENSE AGREEMENT is between the Python Software Foundation
+("PSF"), and the Individual or Organization ("Licensee") accessing and
+otherwise using Python 2.4 software in source or binary form and its
+associated documentation.
+
+2. Subject to the terms and conditions of this License Agreement, PSF
+hereby grants Licensee a nonexclusive, royalty-free, world-wide
+license to reproduce, analyze, test, perform and/or display publicly,
+prepare derivative works, distribute, and otherwise use Python 2.4
+alone or in any derivative version, provided, however, that PSF's
+License Agreement and PSF's notice of copyright, i.e., "Copyright (c)
+2001, 2002, 2003, 2004 Python Software Foundation; All Rights Reserved"
+are retained in Python 2.4 alone or in any derivative version prepared
+by Licensee.
+
+3. In the event Licensee prepares a derivative work that is based on
+or incorporates Python 2.4 or any part thereof, and wants to make
+the derivative work available to others as provided herein, then
+Licensee hereby agrees to include in any such work a brief summary of
+the changes made to Python 2.4.
+
+4. PSF is making Python 2.4 available to Licensee on an "AS IS"
+basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
+IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
+DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
+FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 2.4 WILL NOT
+INFRINGE ANY THIRD PARTY RIGHTS.
+
+5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
+2.4 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
+A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 2.4,
+OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
+
+6. This License Agreement will automatically terminate upon a material
+breach of its terms and conditions.
+
+7. Nothing in this License Agreement shall be deemed to create any
+relationship of agency, partnership, or joint venture between PSF and
+Licensee.  This License Agreement does not grant permission to use PSF
+trademarks or trade name in a trademark sense to endorse or promote
+products or services of Licensee, or any third party.
+
+8. By copying, installing or otherwise using Python 2.4, Licensee
+agrees to be bound by the terms and conditions of this License
+Agreement.
+
+

README

@@ -24,7 +24,10 @@ Installation
 
 Note: the wrappers link with the alsasound library alsa (from the alsa-lib
 package). Verify that this is installed by looking for /usr/lib/libasound.so
-before building. Naturally you also need to use a kernel with proper ALSA
+before building. The libasound development files are also neccesary. On debian
+and derivatives, this is achieved by installing the alsalib-dev package.
+
+Naturally you also need to use a kernel with proper ALSA
 support. This is the default in Linux kernel 2.6 and later. If you are using
 kernel version 2.4 you may need to install the ALSA patches yourself - although
 most distributions ship with ALSA kernels.
@@ -38,13 +41,15 @@ And then as root:
 
 Using the API
 =============
+There is a reasonably usefull API documentation included in the module
+documentation, which can be found in the doc subdirectory of the source
+distribution.
 
-There are two example programs included with the source:
+There are also three example programs included with the source:
 'playbacktest.py' which plays back raw sound data read from
 stdin
 
 'recordtest.py' which captures sound from the microphone at writes
 it raw to stdout.
 
-In a future version, I'll include documentation with the package, but
-for now, you're stuck with the examples.
+'mixertest.py' which can be used to manipulate the mixers

TODO

@@ -1,4 +1,3 @@
-- Write documentation
 - Better example code (aplay,arecord,amixer workalike for example)
 - Implement MIDI/sequencer support.
 

alsaaudio.c

@@ -373,7 +373,7 @@ static PyObject *alsapcm_write(alsapcm_t *self, PyObject *args) {
   int res;
   if (!PyArg_ParseTuple(args,"s#",&data,&datalen)) return NULL;
   if (datalen%self->framesize) {
-    PyErr_SetString(ALSAAudioError,"Data size must be a multipla of framesize");
+    PyErr_SetString(ALSAAudioError,"Data size must be a multiple of framesize");
     return NULL;
   }
   res = snd_pcm_writei(self->handle, data, datalen/self->framesize);

doc/about.html

@@ -1,44 +1,45 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html>
 <head>
-<link rel="STYLESHEET" href="pyalsaaudio.css" type='text/css'>
-<link rel="first" href="pyalsaaudio.html" title='PyAlsaAudio'>
-<link rel='contents' href='contents.html' title="Contents">
-<link rel='last' href='about.html' title='About this document...'>
-<link rel='help' href='about.html' title='About this document...'>
-<LINK REL="prev" href="contents.html">
-<LINK REL="parent" HREF="pyalsaaudio.html">
-<meta name='aesop' content='information'>
-<META NAME="description" CONTENT="About this document ...">
-<META NAME="keywords" CONTENT="pyalsaaudio">
-<META NAME="resource-type" CONTENT="document">
-<META NAME="distribution" CONTENT="global">
+<link rel="STYLESHEET" href="pyalsaaudio.css" type='text/css' />
+<link rel="first" href="pyalsaaudio.html" title='PyAlsaAudio' />
+<link rel='contents' href='contents.html' title="Contents" />
+<link rel='last' href='about.html' title='About this document...' />
+<link rel='help' href='about.html' title='About this document...' />
+<link rel="prev" href="contents.html" />
+<link rel="parent" href="pyalsaaudio.html" />
+<meta name='aesop' content='information' />
 <title>About this document ...</title>
 </head>
 <body>
 <DIV CLASS="navigation">
+<div id='top-navigation-panel' xml:id='top-navigation-panel'>
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><a rel="prev" title="4.4 ALSA Examples" 
-  href="pcm-example.html"><img src='previous.gif'
-  border='0' height='32'  alt='Previous Page' width='32'></A></td>
-<td><a rel="parent" title="PyAlsaAudio" 
-  HREF="pyalsaaudio.html"><img src='up.gif'
-  border='0' height='32'  alt='Up One Level' width='32'></A></td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><a rel="prev" title="4.4 ALSA Examples"
+  href="pcm-example.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="PyAlsaAudio"
+  href="pyalsaaudio.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></td>
 <td align="center" width="100%">PyAlsaAudio</td>
-<td><a rel="contents" title="Table of Contents" 
-  href="contents.html"><img src='contents.gif'
-  border='0' height='32'  alt='Contents' width='32'></A></td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+  href="contents.html"><img src='contents.png'
+  border='0' height='32'  alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
+<div class='online-navigation'>
 <b class="navlabel">Previous:</b>
 <a class="sectref" rel="prev" href="pcm-example.html">4.4 ALSA Examples</A>
 <b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" HREF="pyalsaaudio.html">PyAlsaAudio</A>
-<br><hr>
+<a class="sectref" rel="parent" href="pyalsaaudio.html">PyAlsaAudio</A>
+</div>
+<hr /></div>
 </DIV>
 <!--End of Navigation Panel-->
 
@@ -72,33 +73,36 @@ <H1><A NAME="SECTION003000000000000000000">
 </p>
 
 <DIV CLASS="navigation">
-<p><hr>
+<div class='online-navigation'>
+<p></p><hr />
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><a rel="prev" title="4.4 ALSA Examples" 
-  rel="prev" title="4.4 ALSA Examples" 
-  href="pcm-example.html"><img src='previous.gif'
-  border='0' height='32'  alt='Previous Page' width='32'></A></td>
-<td><a rel="parent" title="PyAlsaAudio" 
-  rel="parent" title="PyAlsaAudio" 
-  HREF="pyalsaaudio.html"><img src='up.gif'
-  border='0' height='32'  alt='Up One Level' width='32'></A></td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><a rel="prev" title="4.4 ALSA Examples"
+  href="pcm-example.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="PyAlsaAudio"
+  href="pyalsaaudio.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></td>
 <td align="center" width="100%">PyAlsaAudio</td>
-<td><a rel="contents" title="Table of Contents" 
-  rel="contents" title="Table of Contents" 
-  href="contents.html"><img src='contents.gif'
-  border='0' height='32'  alt='Contents' width='32'></A></td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+  href="contents.html"><img src='contents.png'
+  border='0' height='32'  alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
+<div class='online-navigation'>
 <b class="navlabel">Previous:</b>
 <a class="sectref" rel="prev" href="pcm-example.html">4.4 ALSA Examples</A>
 <b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" HREF="pyalsaaudio.html">PyAlsaAudio</A>
-<hr>
-<span class="release-info">Release 0.1.</span>
+<a class="sectref" rel="parent" href="pyalsaaudio.html">PyAlsaAudio</A>
+</div>
+</div>
+<hr />
+<span class="release-info">Release 0.2.</span>
 </DIV>
 <!--End of Navigation Panel-->
 

doc/contents.html

@@ -1,52 +1,54 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html>
 <head>
-<link rel="STYLESHEET" href="pyalsaaudio.css" type='text/css'>
-<link rel="first" href="pyalsaaudio.html" title='PyAlsaAudio'>
-<link rel='contents' href='contents.html' title="Contents">
-<link rel='last' href='about.html' title='About this document...'>
-<link rel='help' href='about.html' title='About this document...'>
-<LINK REL="next" href="about.html">
-<LINK REL="prev" href="front.html">
-<LINK REL="parent" HREF="pyalsaaudio.html">
-<LINK REL="next" HREF="node3.html">
-<meta name='aesop' content='information'>
-<META NAME="description" CONTENT="Contents">
-<META NAME="keywords" CONTENT="pyalsaaudio">
-<META NAME="resource-type" CONTENT="document">
-<META NAME="distribution" CONTENT="global">
+<link rel="STYLESHEET" href="pyalsaaudio.css" type='text/css' />
+<link rel="first" href="pyalsaaudio.html" title='PyAlsaAudio' />
+<link rel='contents' href='contents.html' title="Contents" />
+<link rel='last' href='about.html' title='About this document...' />
+<link rel='help' href='about.html' title='About this document...' />
+<link rel="next" href="about.html" />
+<link rel="prev" href="front.html" />
+<link rel="parent" href="pyalsaaudio.html" />
+<link rel="next" href="node3.html" />
+<meta name='aesop' content='information' />
 <title>Contents</title>
 </head>
 <body>
 <DIV CLASS="navigation">
+<div id='top-navigation-panel' xml:id='top-navigation-panel'>
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><a rel="prev" title="Front Matter" 
-  href="front.html"><img src='previous.gif'
-  border='0' height='32'  alt='Previous Page' width='32'></A></td>
-<td><a rel="parent" title="PyAlsaAudio" 
-  HREF="pyalsaaudio.html"><img src='up.gif'
-  border='0' height='32'  alt='Up One Level' width='32'></A></td>
-<td><a rel="next" title="1 What is ALSA" 
-  HREF="node3.html"><img src='next.gif'
-  border='0' height='32'  alt='Next Page' width='32'></A></td>
+<td class='online-navigation'><a rel="prev" title="Front Matter"
+  href="front.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="PyAlsaAudio"
+  href="pyalsaaudio.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="1 What is ALSA"
+  href="node3.html"><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></A></td>
 <td align="center" width="100%">PyAlsaAudio</td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
+<div class='online-navigation'>
 <b class="navlabel">Previous:</b>
 <a class="sectref" rel="prev" href="front.html">Front Matter</A>
 <b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" HREF="pyalsaaudio.html">PyAlsaAudio</A>
+<a class="sectref" rel="parent" href="pyalsaaudio.html">PyAlsaAudio</A>
 <b class="navlabel">Next:</b>
-<a class="sectref" rel="next" HREF="node3.html">1 What is ALSA</A>
-<br><hr>
+<a class="sectref" rel="next" href="node3.html">1 What is ALSA</A>
+</div>
+<hr /></div>
 </DIV>
 <!--End of Navigation Panel-->
-<BR>
-<BR><H2><A NAME="SECTION002000000000000000000">
+<BR><h2><A NAME="SECTION002000000000000000000">
 Contents</A>
-</H2>
+</h2>
 <!--Table of Contents-->
 
 <UL CLASS="TofC">
@@ -65,33 +67,38 @@
 <P>
 
 <DIV CLASS="navigation">
-<p><hr>
+<div class='online-navigation'>
+<p></p><hr />
 <table align="center" width="100%" cellpadding="0" cellspacing="2">
 <tr>
-<td><a rel="prev" title="Front Matter" 
-  rel="prev" title="Front Matter" 
-  href="front.html"><img src='previous.gif'
-  border='0' height='32'  alt='Previous Page' width='32'></A></td>
-<td><a rel="parent" title="PyAlsaAudio" 
-  rel="parent" title="PyAlsaAudio" 
-  HREF="pyalsaaudio.html"><img src='up.gif'
-  border='0' height='32'  alt='Up One Level' width='32'></A></td>
-<td><a rel="next" title="1 What is ALSA" 
-  rel="next" title="1 What is ALSA" 
-  HREF="node3.html"><img src='next.gif'
-  border='0' height='32'  alt='Next Page' width='32'></A></td>
+<td class='online-navigation'><a rel="prev" title="Front Matter"
+  href="front.html"><img src='previous.png'
+  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="PyAlsaAudio"
+  href="pyalsaaudio.html"><img src='up.png'
+  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="1 What is ALSA"
+  href="node3.html"><img src='next.png'
+  border='0' height='32'  alt='Next Page' width='32' /></A></td>
 <td align="center" width="100%">PyAlsaAudio</td>
-<td><img src='blank.gif'
-  border='0' height='32'  alt='' width='32'></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+  border='0' height='32'  alt='' width='32' /></td>
 </tr></table>
+<div class='online-navigation'>
 <b class="navlabel">Previous:</b>
 <a class="sectref" rel="prev" href="front.html">Front Matter</A>
 <b class="navlabel">Up:</b>
-<a class="sectref" rel="parent" HREF="pyalsaaudio.html">PyAlsaAudio</A>
+<a class="sectref" rel="parent" href="pyalsaaudio.html">PyAlsaAudio</A>
 <b class="navlabel">Next:</b>
-<a class="sectref" rel="next" HREF="node3.html">1 What is ALSA</A>
-<hr>
-<span class="release-info">Release 0.1.</span>
+<a class="sectref" rel="next" href="node3.html">1 What is ALSA</A>
+</div>
+</div>
+<hr />
+<span class="release-info">Release 0.2.</span>
 </DIV>
 <!--End of Navigation Panel-->