summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorGuido Cella <guido@guidocella.xyz>2021-07-28 17:00:38 +0200
committerDudemanguy <random342@airmail.cc>2021-07-29 13:38:28 +0000
commit3f0e8bd506e3e3fc6eb9927f0b2d04b23e9105a2 (patch)
tree52f3cfaf94c8888c33462afd7fc57bbe97da14e0 /DOCS/man/options.rst
parent67ddffcc264e4d9af4dd93e82e5f997049ac49d1 (diff)
downloadmpv-3f0e8bd506e3e3fc6eb9927f0b2d04b23e9105a2.tar.bz2
mpv-3f0e8bd506e3e3fc6eb9927f0b2d04b23e9105a2.tar.xz
options: audio-display determines cover priority
Let audio-display determine whether embedded images or external cover art tracks should be selected when both are present. Attached pictures are given priority by default as requested in #8539. Also updates references to attached pictures in the log and manpage to refer to cover art as well. Closes #8539.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst19
1 files changed, 11 insertions, 8 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index a91c4e670e..65626b80c0 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2036,14 +2036,17 @@ Audio
want. For example, most A/V receivers connected via HDMI and that can
do 7.1 would be served by: ``--audio-channels=7.1,5.1,stereo``
-``--audio-display=<no|attachment>``
- Setting this option to ``attachment`` (default) will display image
- attachments (e.g. album cover art) when playing audio files. It will
- display the first image found, and additional images are available as
- video tracks.
-
- Setting this option to ``no`` disables display of video entirely when
- playing audio files.
+``--audio-display=<no|embedded-first|external-first>``
+ Determines whether to display cover art when playing audio files and with
+ what priority. It will display the first image found, and additional images
+ are available as video tracks.
+
+ :no: Disable display of video entirely when playing audio
+ files.
+ :embedded-first: Display embedded images and external cover art, giving
+ priority to embedded images (default).
+ :external-first: Display embedded images and external cover art, giving
+ priority to external files.
This option has no influence on files with normal video tracks.