larsimmisch 6fdbd9a2e5 Imported inline documentation for use with the builtin help function.
To make this work better, I have removed tp_getattr in favor of tp_getattro 
and tp_methods.

This method has much better support for inline help, but relies on 
PyObject_GenericGetAttr.

From trawling through the python branches, it looks as if 
PyObject_GenericGetAttr was introduced in Python 2.2.

I think it is an acceptable to trade better inline documentation with no
support for versions earlier than 2.2.

(I *could* do both, but my time is finite).



git-svn-id: svn://svn.code.sf.net/p/pyalsaaudio/code/trunk@20 ec2f30ec-7544-0410-870e-f70ca00c83f0
2008-01-25 13:42:39 +00:00
2008-01-24 14:49:28 +00:00
2008-01-24 12:30:46 +00:00
2008-01-24 12:30:46 +00:00

PyAlsaAudio
===========

Author: Casper Wilstrup (cwi@unispeed.dk)

This package contains wrappers for accessing the ALSA api from Python. It
is currently fairly complete for PCM devices. My next goal is to have
complete mixer supports as well. MIDI sequencer support is low on my
priority list, but volunteers are welcome.

If you find bugs in the wrappers please notify me on email. Please
don't send bug reports regarding ALSA specifically. There are several
bugs in this api, and those should be reported to the ALSA team - not
me.

This software is licensed under the PSF license - the same one used
by the majority of the python distribution. Basically you can use it
for anything you wish (even commercial purposes). There is no warranty
whatsoever.


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. 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.

To install, execute the following:
  $ python setup.py build

And then as root:
  # python setup.py install


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 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.

'mixertest.py' which can be used to manipulate the mixers
Description
No description provided
Readme 1.1 MiB
Languages
C 88%
Python 11.3%
Shell 0.4%
Makefile 0.3%