initial (incomplete) version of ALSA Audio API tutorial

initial (incomplete) version of ALSA Audio API tutorial

[Paul Davis]

prompted by phil kerr this morning, i started writing a tutorial on
using the ALSA Audio API (the term "PCM" is OK once you get into this
stuff, but ...). The following document represents it current state. I
would like to ask for feedback even though it is very incomplete. I
have not tested any of the programs yet. 

Specific things I would like feedback on:

	 * is this kind of document useful?
	 * are you totally put off by my low level discussion of
	     how an audio interface works?
         * are there design errors in the sample code?
	 * is my assumption that the default sw params settings
	     will work fine actually correct?
         * does the developer need to set period size?	     
	 * what material in particular do you want to see covered
	     by such a tutorial? it is not going to be 
	     a reference work, so keep that in mind. but i am
	     happy to extend it so that it describes (not documents)
	     all aspects of the ALSA Audio API.
         	     
One thing that has to change in the sample code is that there is
currently no error checking for any of the params setting calls. But I
would really appreciate it if Jaroslav and/or Abramo could review the
code and let me know if these examples are OK as simple cases. I also 
want to add more comments to the code to make it clear what they are
doing at each point.

I would appreciate it if anybody has any ideas on a really simple
way to get the playback examples to make a nice noise without
burdening the examples with either waveform generating code and/or
calls to some kind of audio file library.

Anyway, the URL:

	http://www.op.net/~pbd/alsa-audio.html

Let me know. This complaint about a lack of documentation for ALSA has
got to stop soon, and this is my contribution to making that happen
ASAP. My goal is to have a first, finished version of this ready by
the end of this weekend (march 24th).

--p
	

_______________________________________________
Alsa-devel mailing list
Alsa-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/alsa-devel

Re: [linux-audio-dev] initial (incomplete) version of ALSA Audio API tutorial

[Kevin Conder]

On Thu, 21 Mar 2002, Paul Davis wrote:

> prompted by phil kerr this morning, i started writing a tutorial on
> using the ALSA Audio API

	Great!

> (the term "PCM" is OK once you get into this
> stuff, but ...). 

	How about adding PCM to your Terminology section then?

> The following document represents it current state. I
> would like to ask for feedback even though it is very incomplete.

	What is the license for this documentation and its examples?


-- Kevin Conder, kevin@kevindumpscore.com


_______________________________________________
Alsa-devel mailing list
Alsa-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/alsa-devel

Re: Re: [linux-audio-dev] initial (incomplete) version of ALSA Audio API tutorial

[Paul Davis]

>> (the term "PCM" is OK once you get into this
>> stuff, but ...). 
>
>	How about adding PCM to your Terminology section then?

Done.

>> The following document represents it current state. I
>> would like to ask for feedback even though it is very incomplete.
>
>	What is the license for this documentation and its examples?

the code is GPL. the text, i am not sure about at this time. i will at
least add a copyright message for now. 

--p

_______________________________________________
Alsa-devel mailing list
Alsa-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/alsa-devel

Re: initial (incomplete) version of ALSA Audio API tutorial

[markrages]

On Thu, Mar 21, 2002 at 04:31:06PM -0500, Paul Davis wrote:
> prompted by phil kerr this morning, i started writing a tutorial on
> using the ALSA Audio API (the term "PCM" is OK once you get into this
> stuff, but ...). The following document represents it current state. I
> would like to ask for feedback even though it is very incomplete. I
> have not tested any of the programs yet. 
> 

There's some small edits I would make. I'll send a patch when you're done with it.
I wish this was a wiki! (there, out of my system, won't say it again, stay calm Kevin...)

The #includes are interpreted as html by Mozilla and don't display.

Line-by-line comments would be a nice way of increasing "tutorial" content.

It's great to see someone who knows what he's doing taking interest in Alsa documentation.

Regards,
Mark
-- 
Mark Rages
markrages@yahoo.com           
http://mlug.missouri.edu/~markrages
The beginning is near.

_______________________________________________
Alsa-devel mailing list
Alsa-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/alsa-devel