From 57048c7393e94820520a395e569d05cdcc085224 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 5 Jun 2015 22:35:43 +0200 Subject: audio: add --audio-spdif as new method for enabling passthrough This provides a new method for enabling spdif passthrough. The old method via --ad (--ad=spdif:ac3 etc.) is deprecated. The deprecated method will probably stop working at some point. This also supports PCM fallback. One caveat is that it will lose at least 1 audio packet in doing so. (I don't care enough to prevent this.) (This is named after the old S/PDIF connector, because it uses the same underlying technology as far as the higher level protoco is concerned. Also, the user should be renamed that passthrough is backwards.) --- DOCS/man/options.rst | 37 ++++++++++++++++++++++++++++--------- 1 file changed, 28 insertions(+), 9 deletions(-) (limited to 'DOCS/man') diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index f51b471c01..61cd7058c0 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -855,6 +855,25 @@ Audio ``--af-clr`` exist to modify a previously specified list, but you should not need these for typical use. +``--audio-spdif=`` + List of codecs for which compressed audio passthrough should be used. This + works for both classic S/PDIF and HDMI. + + Possible codecs are ``ac3``, ``dts``, ``dts-hd``. Multiple codecs can be + specified by separating them with ``,``. ``dts`` refers to low bitrate DTS + core, while ``dts-hd`` refers to DTS MA (receiver and OS support varies). + You should only use either ``dts`` or ``dts-hd`` (if both are specified, + and ``dts`` comes first, only ``dts`` will be used). + + In general, all codecs in the ``spdif`` family listed with ``--ad=help`` + are supported in theory. + + .. admonition:: Warning + + There is not much reason to use this. HDMI supports uncompressed + multichannel PCM, and mpv supports lossless DTS-HD decoding via + FFmpeg's libdcadec wrapper. + ``--ad=<[+|-]family1:(*|decoder1),[+|-]family2:(*|decoder2),...[-]>`` Specify a priority list of audio decoders to be used, according to their family and decoder name. Entries like ``family:*`` prioritize all decoders @@ -882,6 +901,11 @@ Audio ``--ad=help`` List all available decoders. + .. admonition:: Warning + + Enabling compressed audio passthrough (AC3 and DTS via SPDIF/HDMI) with + this option is deprecated. Use ``--audio-spdif`` instead. + ``--volume=`` Set the startup volume. 0 means silence, 100 means no volume reduction or amplification. A value of -1 (the default) will not change the volume. See @@ -953,17 +977,12 @@ Audio welcome. A full list of AVOptions can be found in the FFmpeg manual. ``--ad-spdif-dtshd=``, ``--dtshd``, ``--no-dtshd`` - When using DTS pass-through, output any DTS-HD track as-is. - With ``ad-spdif-dtshd=no`` (the default), only the DTS Core parts will be - output. + If DTS is passed through, use DTS-HD. - DTS-HD tracks can be sent over HDMI but not over the original - coax/TOSLINK S/PDIF system. - - Some receivers don't accept DTS core-only when ``--ad-spdif-dtshd=yes`` is - used, even though they accept DTS-HD. + .. admonition:: Warning - ``--dtshd`` and ``--no-dtshd`` are deprecated aliases. + This and enabling passthrough via ``--ad`` are deprecated in favor of + using ``--audio-spdif=dts-hd``. ``--audio-channels=`` Request a channel layout for audio output (default: auto). This will ask -- cgit v1.2.3