summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-11-14 23:52:47 +0100
committerwm4 <wm4@nowhere>2014-11-15 00:55:30 +0100
commita6694d27889b4b65ab6d05641396724ae9696f77 (patch)
tree3c41306de3089dedd84378c7c3c3c8632ffdfe3a /DOCS/man
parentd484cb3f3245573ec024d6a50099d9a5a5e4400d (diff)
downloadmpv-a6694d27889b4b65ab6d05641396724ae9696f77.tar.bz2
mpv-a6694d27889b4b65ab6d05641396724ae9696f77.tar.xz
demux_mkv: adjust subtitle preroll again (2)
Make the changes started in commit c827ae5f more eloborate, and provide an option to control the amount of data read before the seek-target. To achieve this, rewrite the loop that finds the lowest still acceptable target cluster. It is now searched by time instead of file position. The behavior (both with and without preroll option) may be different from before this change, although it shouldn't be worse. The change demux_mkv_read_cues() fixes a bug: when seeking after playing normally, the code would erroneously assume that durations are set. This doesn't happen if the first operation after loading was a seek instead of playback.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/options.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 8cd30d7fcf..feaeac6b30 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2038,6 +2038,22 @@ Demuxer
and hr-seeks, and this option changes behavior with relative or imprecise
seeks only.
+ You can use the ``--demuxer-mkv-subtitle-preroll-secs`` option to specify
+ how mach data the demuxer should pre-read at most in order to find subtitle
+ packets that may overlap. Setting this to 0 will effectively disable this
+ preroll mechanism. Setting a very large value can make seeking very slow,
+ and an extremely large value would completely reread the entire file from
+ start to seek target on every seek - seeking can become slower towards the
+ end of the file. The details are messy, and the value is actually rounded
+ down to the cluster with the previous video keyframe.
+
+ Some files, especially files muxed with newer mkvmerge versions, have
+ information embedded that can be used to determine what subtitle packets
+ 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.)
+
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,
but makes seeking much slower, as it has to decode audio and video data
@@ -2045,6 +2061,9 @@ Demuxer
``--mkv-subtitle-preroll`` is a deprecated alias.
+``--demuxer-mkv-subtitle-preroll-secs=<value>``
+ See ``--demuxer-mkv-subtitle-preroll``.
+
``--demuxer-rawaudio-channels=<value>``
Number of channels (or channel layout) if ``--demuxer=rawaudio`` is used
(default: stereo).