[FFmpeg-cvslog] pulse: documentation

[Luca Barbato]

ffmpeg | branch: master | Luca Barbato <lu_zero at gentoo.org> | Wed Oct 26 09:27:54 2011 -0700| [c4b97fbdfabb9d252a13c9c1f7bc8e1c2e9e43c5] | committer: Luca Barbato

pulse: documentation

Specify avoptions and how to use pactl to list devices.

Signed-off-by: Luca Barbato <lu_zero at gentoo.org>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=c4b97fbdfabb9d252a13c9c1f7bc8e1c2e9e43c5
---

 doc/indevs.texi |   83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 83 insertions(+), 0 deletions(-)

diff --git a/doc/indevs.texi b/doc/indevs.texi
index e1c058b..87dee70 100644
--- a/doc/indevs.texi
+++ b/doc/indevs.texi
@@ -154,6 +154,89 @@ ffmpeg -f oss -i /dev/dsp /tmp/oss.wav
 For more information about OSS see:
 @url{http://manuals.opensound.com/usersguide/dsp.html}
 
+ at section pulse
+
+pulseaudio input device.
+
+To enable this input device during configuration you need libpulse-simple
+installed in your system.
+
+The filename to provide to the input device is a source device or the
+string "default"
+
+To list the pulse source devices and their properties you can invoke
+the command @file{pactl list sources}.
+
+ at example
+avconv -f pulse -i default /tmp/pulse.wav
+ at end example
+
+ at subsection @var{server} AVOption
+
+The syntax is:
+ at example
+-server @var{server name}
+ at end example
+
+Connects to a specific server.
+
+ at subsection @var{name} AVOption
+
+The syntax is:
+ at example
+-name @var{application name}
+ at end example
+
+Specify the application name pulse will use when showing active clients,
+by default it is "libav"
+
+ at subsection @var{stream_name} AVOption
+
+The syntax is:
+ at example
+-stream_name @var{stream name}
+ at end example
+
+Specify the stream name pulse will use when showing active streams,
+by default it is "record"
+
+ at subsection @var{sample_rate} AVOption
+
+The syntax is:
+ at example
+-sample_rate @var{samplerate}
+ at end example
+
+Specify the samplerate in Hz, by default 48kHz is used.
+
+ at subsection @var{channels} AVOption
+
+The syntax is:
+ at example
+-channels @var{N}
+ at end example
+
+Specify the channels in use, by default 2 (stereo) is set.
+
+ at subsection @var{frame_size} AVOption
+
+The syntax is:
+ at example
+-frame_size @var{bytes}
+ at end example
+
+Specify the number of byte per frame, by default it is set to 1024.
+
+ at subsection @var{fragment_size} AVOption
+
+The syntax is:
+ at example
+-fragment_size @var{bytes}
+ at end example
+
+Specify the minimal buffering fragment in pulseaudio, it will affect the
+audio latency. By default it is unset.
+
 @section sndio
 
 sndio input device.