From f0feea55918e133ba3e6871e2bb1cbd9610cb2d1 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 13 Nov 2015 22:41:41 +0100 Subject: command: rename vo-missed-frame-count property "Missed" implies the frame was dropped, but what really happens is that the following frame will be shown later than intended (due to the current frame skipping a vsync). (As of this commit, this property is still inactive and always returns 0. See git blame for details.) --- DOCS/man/input.rst | 5 +++++ DOCS/man/mpv.rst | 12 +++++------- 2 files changed, 10 insertions(+), 7 deletions(-) (limited to 'DOCS') diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 108c7a0de2..50ac4dbfbf 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -921,6 +921,11 @@ Property list (which can happen especially with bad source timestamps). For example, using the ``display-desync`` mode should never change this value from 0. +``vo-delayed-frame-count`` + Estimated number of frames delayed due to external circumstances in + display-sync mode. Note that in general, mpv has to guess that this is + happening, and the guess can be inaccurate. + ``percent-pos`` (RW) Position in current file (0-100). The advantage over using this instead of calculating it out of other properties is that it properly falls back to diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index b8bd266aa4..3e45f93072 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -566,13 +566,11 @@ listed. this will indicate a problem. (``total-avsync-change`` property.) - Encoding state in ``{...}``, only shown in encoding mode. - Display sync state. If display sync is active (``display-sync-active`` - property), this shows ``DS: +0.02598%``, where the number is the speed change - factor applied to audio to achieve sync to display, expressed in percent - deviation from 1.0 (``audio-speed-correction`` property). In sync modes which - don't resample, this will always be ``+0.00000%``. -- Missed frames, e.g. ``Missed: 4``. (``vo-missed-frame-count`` property.) Shows - up in display sync mode only. This is incremented each time a frame took - longer to display than intended. + property), this shows ``DS: 12/13``, where the first number is the number of + frames where a vsync was intentionally added or removed + (``mistimed-frame-count``), and the second number of estimated number of vsyncs + which took too long (``vo-delayed-frame-count`` property). The latter is a + heuristic, as it's generally not possible to determine this with certainty. - Dropped frames, e.g. ``Dropped: 4``. Shows up only if the count is not 0. Can grow if the video framerate is higher than that of the display, or if video rendering is too slow. Also can be incremented on "hiccups" and when the video -- cgit v1.2.3