diff options
| author | wm4 <wm4@nowhere> | 2015-08-10 18:43:25 +0200 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2015-08-10 18:48:45 +0200 |
| commit | 031555fbe6cfdf6d0db3b0a5a316dd55efd75846 (patch) | |
| tree | 478cf20c66af2f1a465dd9657b6131afa548a877 /DOCS/man/mpv.rst | |
| parent | fedaad8250b9c9e262da3cda2114ccf5b62703a3 (diff) | |
| download | mpv-031555fbe6cfdf6d0db3b0a5a316dd55efd75846.tar.bz2 mpv-031555fbe6cfdf6d0db3b0a5a316dd55efd75846.tar.xz | |
player: add display sync mode
If this mode is enabled, the player tries to strictly synchronize video
to display refresh. It will adjust playback speed to match the display,
so if you play 23.976 fps video on a 24 Hz screen, playback speed is
increased by approximately 1/1000. Audio wll be resampled to keep up
with playback.
This is different from the default sync mode, which will sync video to
audio, with the consequence that video might skip or repeat a frame once
in a while to make video keep up with audio.
This is still unpolished. There are some major problems as well; in
particular, mkv VFR files won't work well. The reason is that Matroska
is terrible and rounds timestamps to milliseconds. This makes it rather
hard to guess the framerate of a section of video that is playing. We
could probably fix this by just accepting jittery timestamps (instead
of explicitly disabling the sync code in this case), but I'm not ready
to accept such a solution yet.
Another issue is that we are extremely reliant on OS video and audio
APIs working in an expected manner, which of course is not too often
the case. Consequently, the new sync mode is a bit fragile.
Diffstat (limited to 'DOCS/man/mpv.rst')
| -rw-r--r-- | DOCS/man/mpv.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index 97c70e910b..e2487ddfda 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -526,6 +526,13 @@ listed. if there is audio "missing", or not enough frames can be dropped. Usually 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: 1.002``, where the number is the speed change + factor applied to audio to achieve sync to display (``audio-speed-correction`` + property). In sync modes which don't resample, this will always be ``1.000``. +- 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. - 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 |