From 3709ce6718bed8a113d141cdf5e8198f22f3c5f7 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 14 Apr 2017 19:19:44 +0200 Subject: demux: estimate total packet size, deprecate packet number limits It's all explained in the DOCS changes. Although this option was always kind of obscure and pointless. Until it is removed, the only reason for setting it would be to raise the static default limit, so change its default to INT_MAX so that it does nothing by default. --- DOCS/interface-changes.rst | 1 + DOCS/man/options.rst | 18 ++++++++++++------ 2 files changed, 13 insertions(+), 6 deletions(-) (limited to 'DOCS') diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index d2618e1945..0e1fa35666 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -44,6 +44,7 @@ Interface changes - deprecate --loop - after a deprecation period, it will be undeprecated, but changed to alias --loop-file - add --keep-open-pause=no + - deprecate --demuxer-max-packets --- mpv 0.24.0 --- - deprecate --hwdec-api and replace it with --opengl-hwdec-interop. The new option accepts both --hwdec values, as well as named backends. diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 5814a41634..7d3070fda0 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -2754,20 +2754,26 @@ Demuxer ``--demuxer-rawvideo-size=`` Frame size in bytes when using ``--demuxer=rawvideo``. -``--demuxer-max-packets=``, ``--demuxer-max-bytes=`` +``--demuxer-max-bytes=`` This controls how much the demuxer is allowed to buffer ahead. The demuxer will normally try to read ahead as much as necessary, or as much is - requested with ``--demuxer-readahead-secs``. The ``--demuxer-max-...`` - options can be used to restrict the maximum readahead. This limits excessive - readahead in case of broken files or desynced playback. The demuxer will - stop reading additional packets as soon as one of the limits is reached. - (The limits still can be slightly overstepped due to technical reasons.) + requested with ``--demuxer-readahead-secs``. The option can be used to + restrict the maximum readahead. This limits excessive readahead in case of + broken files or desynced playback. The demuxer will stop reading additional + packets as soon as one of the limits is reached. (The limits still can be + slightly overstepped due to technical reasons.) Set these limits higher if you get a packet queue overflow warning, and you think normal playback would be possible with a larger packet queue. See ``--list-options`` for defaults and value range. +``--demuxer-max-packets=`` + Quite similar ``--demuxer-max-bytes=``. Deprecated, because the + other option does basically the same job. Since mpv 0.25.0, the code + tries to account for per-packet overhead, which is why this option becomes + rather pointless. + ``--demuxer-thread=`` Run the demuxer in a separate thread, and let it prefetch a certain amount of packets (default: yes). Having this enabled may lead to smoother -- cgit v1.2.3