summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-12-27 01:01:25 +0100
committerwm4 <wm4@nowhere>2015-12-27 02:13:06 +0100
commitd9f8b9f7b235e6092a1e8b35041757e28e08de04 (patch)
tree78fc8a98310492d0a69a7e657526aa665a41d23b /DOCS
parentd804e7b903e311824edcc3dee2c39e0754cccaf1 (diff)
downloadmpv-d9f8b9f7b235e6092a1e8b35041757e28e08de04.tar.bz2
mpv-d9f8b9f7b235e6092a1e8b35041757e28e08de04.tar.xz
demux_mkv: adjust subtitle preroll defaults
Always preroll by default if the cue (index) information indicates overlapping subtitles. Increase the amount of maximum data it will skip to get such subtitles to 10 seconds. Since the index information can reliably tell whether reading earlier is needed, the maximum should be rarely actually used, thus we can set it high. On the other hand, the "old" prerolling mechanism always has to skip the maximum amount of data; thus the method using the index gets its own option to control the maximum amount of data to skip. (As more and more files With newer mkvtoolnix versions are muxed, and with this new and hopefully sane default established, these options can probably be removed in the future.)
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst11
1 files changed, 9 insertions, 2 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index e5b8499520..76ae596519 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2221,7 +2221,7 @@ Demuxer
Encryption key the demuxer should use. This is the raw binary data of
the key converted to a hexadecimal string.
-``--demuxer-mkv-subtitle-preroll``, ``--mkv-subtitle-preroll``
+``--demuxer-mkv-subtitle-preroll=<yes|index|no>``, ``--mkv-subtitle-preroll``
Try harder to show embedded soft subtitles when seeking somewhere. Normally,
it can happen that the subtitle at the seek target is not shown due to how
some container file formats are designed. The subtitles appear only if
@@ -2253,7 +2253,11 @@ Demuxer
overlap with a seek target. In these cases, mpv will reduce the amount
of data read to a minimum. (Although it will still read *all* data between
the cluster that contains the first wanted subtitle packet, and the seek
- target.)
+ target.) If the ``index`` choice (which is the default) is specified, then
+ prerolling will be done only if this information is actually available. If
+ this method is used, the maximum amount of data to skip can be additionally
+ controlled by ``--demuxer-mkv-subtitle-preroll-secs-index`` (it still uses
+ the value of the option without ``-index`` if that is higher).
See also ``--hr-seek-demuxer-offset`` option. This option can achieve a
similar effect, but only if hr-seek is active. It works with any demuxer,
@@ -2265,6 +2269,9 @@ Demuxer
``--demuxer-mkv-subtitle-preroll-secs=<value>``
See ``--demuxer-mkv-subtitle-preroll``.
+``--demuxer-mkv-subtitle-preroll-secs-index=<value>``
+ See ``--demuxer-mkv-subtitle-preroll``.
+
``--demuxer-mkv-probe-video-duration=<yes|no|full>``
When opening the file, seek to the end of it, and check what timestamp the
last video packet has, and report that as file duration. This is strictly