summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-05-09 13:57:44 +0200
committerwm4 <wm4@nowhere>2013-05-12 21:24:56 +0200
commit9d1f5e8e9f16737b732918a8924c23ee70886db5 (patch)
tree55d92975861c08cdd0ef1ce4ef2426d971c9a42f /DOCS
parent20a1d0bc5bd0de88f83d3b7f468ea8ffbfbfe1e3 (diff)
downloadmpv-9d1f5e8e9f16737b732918a8924c23ee70886db5.tar.bz2
mpv-9d1f5e8e9f16737b732918a8924c23ee70886db5.tar.xz
manpage: update --channels
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst21
1 files changed, 10 insertions, 11 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 03f09b2efc..f528c3f849 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -357,25 +357,24 @@
--cdrom-device=<path>
Specify the CD-ROM device (default: ``/dev/cdrom``).
---channels=<number>
+--channels=<number|layout>
Request the number of playback channels (default: 2). mpv asks the
decoder to decode the audio into as many channels as specified. Then it is
up to the decoder to fulfill the requirement. This is usually only
- important when playing videos with AC-3 audio (like DVDs). In that case
- liba52 does the decoding by default and correctly downmixes the audio into
- the requested number of channels. To directly control the number of output
- channels independently of how many channels are decoded, use the channels
- filter (``--af=channels``).
+ important when playing videos with AC-3, AAC or DTS audio. In that case
+ libavcodec downmixes the audio into the requested number of channels if
+ possible.
*NOTE*: This option is honored by codecs (AC-3 only), filters (surround)
and audio output drivers (OSS at least).
- Available options are:
+ The ``--channels`` option either takes a channel number or an explicit
+ channel layout. Channel numbers refer to default layouts, e.g. 2 channels
+ refer to stereo, 6 refers to 5.1.
- :2: stereo
- :4: surround
- :6: full 5.1
- :8: full 7.1
+ See ``--channels=help`` output for defined default layouts. This also
+ lists speaker names, which can be used to express arbitrary channel
+ layouts (e.g. ``fl-fr-lfe`` is 2.1).
--chapter=<start[-end]>
Specify which chapter to start playing at. Optionally specify which