diff options
author | Dudemanguy <random342@airmail.cc> | 2022-06-19 19:40:20 -0500 |
---|---|---|
committer | Dudemanguy <random342@airmail.cc> | 2022-06-22 03:55:49 +0000 |
commit | 24f4582b6f7f57f566418551f9252b8578d2b602 (patch) | |
tree | 17888dcd02b9799903131f51ad67efe2c124c0e5 /DOCS | |
parent | d9f7dd7212b6306350c8b4c6e0b1959f384fb272 (diff) | |
download | mpv-24f4582b6f7f57f566418551f9252b8578d2b602.tar.bz2 mpv-24f4582b6f7f57f566418551f9252b8578d2b602.tar.xz |
x11: add --x11-present option
With the recent addition of the libxpresent, it should improve frame
timings for most users. However, there were known cases of bad behavior
(Nvidia) which lead to a construction of a whitelist instead of just
enabling this all the time. Since there's no way to predict whatever
combination of hardware/drivers/etc. may work correctly, just give users
an option to switch the usage of xorg's presentation statistics on/off.
The default value, auto, works like before (basically, Mesa drivers and
no Nvidia are allowed), but now one can force it on/off if needed.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/interface-changes.rst | 1 | ||||
-rw-r--r-- | DOCS/man/options.rst | 17 |
2 files changed, 18 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index 4cd93ab6ab..1c3e6496a9 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -42,6 +42,7 @@ Interface changes - `--sub-visibility` no longer has any effect on secondary subtitles - add `film-grain` sub-parameter to `format` video filter - add experimental `--vo=vaapi-wayland` video output driver + - add `--x11-present` for controlling whether to use xorg's present extension --- mpv 0.34.0 --- - deprecate selecting by card number with `--drm-connector`, add `--drm-device` which can be used instead diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index e3aeb4b5bb..59fc79c89e 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -3354,6 +3354,23 @@ Window ``never`` asks the window manager to never disable the compositor. +``--x11-present=<no|auto|yes>`` + Whether or not to use presentation statistics from X11's presentation + extension (default: ``auto``). + + mpv asks X11 for present events which it then may use for more accurate + frame presentation. This only has an effect if ``--video-sync=display-...`` + is being used. + + The auto option enumerates XRandr providers for autodetection. If amd, radeon, + intel, or nouveau (the standard x86 Mesa drivers) is found and nvidia is NOT + found, presentation feedback is enabled. Other drivers are not assumed to + work, so they are not enabled automatically. + + ``yes`` or ``no`` can still be passed regardless to enable/disable this + mechanism in case there is good/bad behavior with whatever your combination + of hardware/drivers/etc. happens to be. + Disc Devices ------------ |