diff options
author | wm4 <wm4@nowhere> | 2018-03-13 11:23:23 +0100 |
---|---|---|
committer | Kevin Mitchell <kevmitch@gmail.com> | 2018-03-15 23:13:53 -0700 |
commit | 2c572e2bb1cfa4e225a6a1599f5ecdbcf4bf2dc6 (patch) | |
tree | d1006df2ce7b6ce598e7617cdb0fff6bb9575f69 /DOCS | |
parent | 9ca1a1b0686510d2b6471b36df9d0eea3fcfa3b3 (diff) | |
download | mpv-2c572e2bb1cfa4e225a6a1599f5ecdbcf4bf2dc6.tar.bz2 mpv-2c572e2bb1cfa4e225a6a1599f5ecdbcf4bf2dc6.tar.xz |
video: add an option to tune waiting for video timing
Probably mostly useful for the libmpv render API.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/options.rst | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 8713cf7244..16e4998453 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -5410,6 +5410,26 @@ Miscellaneous out. This delay in reaction time to sudden A/V offsets should be the only side effect of turning this option on, for all sound drivers. +``--video-timing-offset=<seconds>`` + Control how long before video display target time the frame should be + rendered (default: 0.050). If a video frame should be displayed at a + certain time, the VO will start rendering the frame earlier, and then will + perform a blocking wait until the display time, and only then "swap" the + frame to display. The rendering cannot start before the previous frame is + displayed, so this value is implicitly limited by the video framerate. With + normal video frame rates, the default value will ensure that rendering is + always immediately started after the previous frame was displayed. On the + other hand, setting a too high value can reduce responsiveness with low + FPS value. + + For client API users using the render API (or the deprecated ``opengl-cb`` + API), this option is interesting, because you can stop the render API + from limiting your FPS (see ``mpv_render_context_render()`` documentation). + + This applies only to audio timing modes (e.g. ``--video-sync=audio``). In + other modes (``--video-sync=display-...``), video timing relies on vsync + blocking, and this option is not used. + ``--video-sync=<audio|...>`` How the player synchronizes audio and video. |