From 8c756d55da58779388cb07a2e135ba3f8ef3988c Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Fri, 20 Aug 2004 13:06:55 +0000 Subject: documentation update git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@146 fefdeb5f-60dc-0310-8127-8f9354f1896f --- doc/README.html.in | 31 ++++++++++++++++++++----- doc/cli.html.in | 65 ++++++++++++++++++++++++++++++++++++++++++++--------- doc/modules.html.in | 11 ++++++++- 3 files changed, 90 insertions(+), 17 deletions(-) (limited to 'doc') diff --git a/doc/README.html.in b/doc/README.html.in index f3be2b57..e3736c86 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -97,10 +97,6 @@ href="modules.html">modules.html, cli.html, daemon.html.

-

You may browse the Doxygen generated programing -documentation for the client API. (Run make doxygen to generate this documentation from the source tree)

-

First Steps

Simply start the polypaudio daemon with the argument -C

@@ -114,13 +110,36 @@ documentation for the client API. (Run make doxygen to generate thi

Now you can issue CLI commands as described in cli.html. Another way to start -polypaudio is by specifying a configuration script on the -command line like that one included in the distribution:

+polypaudio is by specifying a configuration script like that one included in the distribution on the +command line :

polypaudio -F polypaudio.pa

This will load some drivers and protocols automatically.

+

Developing polypaudio Clients

+ +

You may browse the Doxygen generated programing +documentation for the client API. (Run make doxygen to generate this documentation from the source tree)

+ +

Developing polypaudio Modules

+ +

There are several reasons for writing loadable modules for polypaudio:

+ + + +

There is currently no documentation how to write loadable modules +for polypaudio. Read the source, Luke! If you are interested in +writing new modules feel free to contact the author in case you have any +questions.

+

Requirements

Currently, polypaudio is tested on Linux only. It requires an OSS or ALSA compatible soundcard.

diff --git a/doc/cli.html.in b/doc/cli.html.in index c67d78db..01c04cc9 100644 --- a/doc/cli.html.in +++ b/doc/cli.html.in @@ -87,7 +87,45 @@ input list. The same volume rules apply as with sink_volume.

(resp. ssource) by its index in the sink (resp. source) list or by its name.

-

Killing clients/streams

+

Sample Cache

+ +

scache_list

+ +

Lists the contents of the sample cache.

+ +

scache_play

+ +

Play a sample cache entry to a sink. Expects the sample name and the sink name as arguments.

+ +

sache_remove

+ +

Remove an entry from the sample cache. Expects the sample name as argument.

+ +

sache_load

+ +

Load an audio file to the sample cache. Expects the file name to load and the desired sample name as arguments.

+ +

Module Autoloading

+ +

autoload_list

+ +

Lists all currently defined autoloading entries.

+ +

autoload_sink_add/autoload_source_add

+ +

Adds an autoloading entry for a sink (resp. source). Expects the sink name (resp. source name), the module name and the module arguments as arguments.

+ +

autoload_sink_remove/autoload_source_remove

+ +

Remove an autoloading entry. Expects the sink name (resp. source name) as argument.

+ +

Miscellaneous Commands

+ +

play_file

+ +

Play an audio file to a sink. Expects the file name and the sink name as argumens.

+ +

Killing Clients/Streams

kill_client

@@ -120,12 +158,14 @@ on the interactive command line.

Example Configuration Script

+

Mark the following script as executable (chmod +x) and run it for a sensible polypaudio configuration.

+ 
 #!/usr/bin/polaudio -F
 
-# Load audio drivers
-load module-alsa-sink device=plughw:0,0 rate=48000
-load module-alsa-source device=hw:1,0
+# Create autoload entries for the device drivers
+autoload_sink_add output module-alsa-sink device=plughw:0,0 rate=48000 sink_name=output
+autoload_source_add input load module-alsa-source device=hw:1,0 source_name=input
 
 # Load several protocols
 load module-esound-protocol-tcp
@@ -136,17 +176,22 @@ load module-cli-protocol-unix
 # Load the CLI module (This is similar to passing "-C" on the command line of polypaudio)
 load module-cli
 
+# Make some devices default
+sink_default output
+source_default input
+
+# Don't fail if the audio files referred to below don't exist
 .nofail
 
-# Make some devices default
-sink_default alsa_output
-source_default alsa_input
+# Load an audio to the sample cache for usage with module-x11-bell
+scache_load /usr/share/sounds/KDE_Notify.wav x11-bell
+load module-x11-bell
 
-# Use digital amplification
-sink_volume alsa_output 0x200
+# Play a welcome sound
+play_file /usr/share/sounds/startup3.wav output
-
Lennart Poettering <@PACKAGE_BUGREPORT@>, July 2004
+
Lennart Poettering <@PACKAGE_BUGREPORT@>, August 2004
$Id$
diff --git a/doc/modules.html.in b/doc/modules.html.in index 6954418f..fe202989 100644 --- a/doc/modules.html.in +++ b/doc/modules.html.in @@ -184,8 +184,17 @@ about the two possible suffixes of this module.

cookie=Name of the cookie file for authentication purposes +

module-x11-bell

+ +

Intercepts X11 bell events and plays a sample from the sample cache on each occurence.

+ + + + + +
display=X11 display to connect to. If ommited defaults to the value of $DISPLAY
sample=The sample to play. If ommited defaults to x11-bell.
sink=Name of the sink to play the sample on. If ommited defaults to the default sink.
-
Lennart Poettering <@PACKAGE_BUGREPORT@>, July 2004
+
Lennart Poettering <@PACKAGE_BUGREPORT@>, August 2004
$Id$
-- cgit