summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2012-12-10 18:52:06 +0100
committerwm4 <wm4@nowhere>2012-12-11 00:37:55 +0100
commitfdbf43705581ee676d3e1d22210def3e21ce8fb3 (patch)
tree55552d37157f98715ea91d14f48b970fd39988e1 /DOCS
parent74ab902dea669bb3d6d3769d8a96640ca538a535 (diff)
downloadmpv-fdbf43705581ee676d3e1d22210def3e21ce8fb3.tar.bz2
mpv-fdbf43705581ee676d3e1d22210def3e21ce8fb3.tar.xz
core: allow disabling display of "album art" in audio files
ffmpeg pretends that image attachments (such as contained in ID3v2 metadata) are video streams. It injects the attached pictures as packets into the packet stream received with av_read_frame(). Add the --audio-display option to allow configuring whether attached pictures should be displayed. The default behavior doesn't change (images are displayed). Identify video streams, that are actually image attachments, with "[P]" in the terminal output. Modify the default stream selection such that real video streams are preferred over attached pictures. (This is just for robustness; I do not know of any samples where images are added before actual video streams and could lead to bad default stream selection with the old code.)
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 253bea472b..1d8798f260 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -186,6 +186,16 @@
name to force it, this will skip some checks! Give the demuxer name as
printed by ``--audio-demuxer=help``. ``--audio-demuxer=audio`` forces MP3.
+--audio-display=<no|attachment>
+ Setting this option to ``attachment`` (default) will display image
+ attachments when playing audio files. It will display the first image
+ found, and additional images are available as video streams.
+
+ Setting this option to ``no`` disables display of video entirely when
+ playing audio files.
+
+ This option has no influence on files with normal video tracks.
+
--audiofile=<filename>
Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
movie.