From c29b3f11e271757d60e72480030011913f778878 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 26 Apr 2006 21:31:51 +0000 Subject: doc update for 0.8.1 git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@812 fefdeb5f-60dc-0310-8127-8f9354f1896f --- doc/FAQ.html.in | 48 +++++++++++++++++++++++++++++++++++++++++++++++- doc/README.html.in | 19 +++++++++++++++++++ doc/modules.html.in | 17 +++++++++++++++-- 3 files changed, 81 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/FAQ.html.in b/doc/FAQ.html.in index 7adc2441..a042dd7b 100644 --- a/doc/FAQ.html.in +++ b/doc/FAQ.html.in @@ -224,7 +224,7 @@ load-module module-rtp-recv sink=rtp set-default-source rtp_monitor -

Now the audio data will be available from the default source rtp_monitor.

When sending multicast RTP traffic it is recieved on the entire LAN but not by the sender machine itself!

@@ -237,6 +237,52 @@ the destination/sap_address arguments of the RTP modules to select them. Choose your group addresses from the range 225.0.0.x to make sure the audio data never leaves the LAN.

+ +

Can I use Polypaudio to playback music on two sound cards simultaneously?

+ +

Yes! Use module-combine for that.

+ +

+load-module module-oss-mmap device="/dev/dsp" sink_name=output0
+load-module module-oss-mmap device="/dev/dsp1" sink_name=output1
+load-module module-combine sink_name=combined master=output0 slaves=output1
+set-sink-default combined
+

+ +

This will combine the two sinks output0 and +output1 into a new sink combined. Every sample +written to the latter will be forwarded to the former two. Polypaudio +will make sure to adjust the sample rate of the slave device in case +it deviates from the master device. You can have more than one slave +sink attached to the combined sink, and hence combine even three and +more sound cards.

+ +

Can I use Polypaudio to combine two stereo soundcards into a virtual surround sound card?

+ +

Yes! You can use use module-combine for that.

+ +

+load-module module-oss-mmap device="/dev/dsp" sink_name=output0 channel_map=left,right channels=2
+load-module module-oss-mmap device="/dev/dsp1" sink_name=output1 channel_map=rear-left,rear-right channels=2
+load-module module-combine sink_name=combined master=output0 slaves=output1 channel_map=left,right,rear-left,rear-right channels=4
+

+ +

This is mostly identical to the previous example. However, this +time we manually specify the channel mappings for the sinks to make +sure everything is routed correctly.

+ +

Please keep in mind that Polypaudio will constantly adjust the +sample rate to compensate for the deviating quartzes of the sound +devices. This is not perfect, however. Deviations in a range of +1/44100s (or 1/48000s depending on the sampling frequency) can not be +compensated. The human ear will decode these deviations as minor +movements (less than 1cm) of the positions of the sound sources +you hear.

+ +

+ + +

diff --git a/doc/README.html.in b/doc/README.html.in index 5dec5056..2ed75edf 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -22,6 +22,7 @@

License

@@ -42,6 +43,14 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

News

Wed Apr 26 2006:

Version 0.8.1 +released; changes include: support for specifying the channel map on +the command lines of paplay and pacat and as +arguments to the driver modules; ALSA hardware mixer compatibility; +fix linking; properly remove PF_UNIX sockets when unloading +protocol modules; fix sample cache; many other fixes

Thu Apr 13 2006:

Version 0.8 released; changes include: too many to count - consider reading this blog entry for more information; many, many minor fixes.

@@ -288,6 +297,10 @@ compilation and make install (as root) for installation of

Cendio AB for paying for Pierre's work on Polypaudio

Sebastien ESTIENNE for testing

+ +

Igor Zubkov for some portability patches

Download

The newest release is always available from @PACKAGE_URL@

@@ -298,10 +311,16 @@ compilation and make install (as root) for installation of

svn checkout svn://0pointer.de/polypaudio/trunk polypaudio

Community

If you want to be notified whenever I release a new version of this software use the subscription feature of Freshmeat.

There is a general discussion mailing list for polypaudio available. In addition, you can subscribe to SVN changes and Trac Tickets.

Polypaudio is being tracked at CIA.

+ +

There's a chance to meet the Polypaudio developers on our IRC channel #polypaudio on irc.freenode.org.

There is a Trac based Wiki for Polypaudio available.

Please report bugs to our Trac ticket system.

diff --git a/doc/modules.html.in b/doc/modules.html.in index f7b6298f..6a6b7887 100644 --- a/doc/modules.html.in +++ b/doc/modules.html.in @@ -20,7 +20,19 @@ rate=The sample rate (defaults to 44100) channels=Audio channels (defaults to 2) sink_name=, source_name=Name for the sink (resp. source) - + channel_map=Channel map. A list of +comma-seperated channel names. The currently defined channel names +are: left, right, mono, center, +front-left, front-right, front-center, +rear-center, rear-left, rear-right, +lfe, subwoofer, front-left-of-center, +front-right-of-center, side-left, +side-right, aux0, aux1 to aux15, +top-center, top-front-left, +top-front-right, top-front-center, +top-rear-left, top-rear-right, +top-rear-center, (Default depends on the number of channels +and the driver)

module-pipe-sink

@@ -118,12 +130,13 @@ compatible as module-oss.

This module supports all arguments thet module-oss supports except device=.

module-combine

This combines two or more sinks into one. A new virtual sink is allocated. All data written to it is forwarded to all connected sinks. In aequidistant intervals the sample rates of the output sinks -is recalculated: i.e. even when the sink's crystals deviate (which is +is recalculated: i.e. even when the sinks' crystals deviate (which is normally the case) output appears synchronously to the human ear. The resampling required for this may be very CPU intensive.

-- cgit