summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2022-05-31 08:36:15 -0500
committerDudemanguy <random342@airmail.cc>2022-08-14 16:04:49 +0000
commitf0011552e7bd0d7ecaac02069781ef23973d411e (patch)
treef079965b37baaf98b08caf7322c537bbda766e5a /DOCS
parentf781dddabcaf0c7127e28cea1ed035847ef85c06 (diff)
downloadmpv-f0011552e7bd0d7ecaac02069781ef23973d411e.tar.bz2
mpv-f0011552e7bd0d7ecaac02069781ef23973d411e.tar.xz
wayland: add support for configure bounds
In wayland-protocols 1.25, xdg-shell got a version bump which added the configure_bounds event. The compositor can send this to clients to indicate that they should not resize past a certain size. For mpv, we'll choose to only listen to this on reconfig events (i.e. when the window first appears and if the video resolution changes later in the playlist). However, this behavior is still exposed as a user option (default on) because it will neccesarily conflict with a user setting a specific geometry size and/or window scale. Presumably, if someone is setting a really large size that goes beyond the bounds of their monitor, they actually want it like that. The wayland-protocols version is newer-ish, but we can get around having to poke the build system by just using a define that exists in the generated xdg-shell header.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst8
2 files changed, 9 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 6629d3ee09..128d045a13 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -45,6 +45,7 @@ Interface changes
- add `--x11-present` for controlling whether to use xorg's present extension
- add `engine` option to the `rubberband` audio filter to support the new
engine introduced in rubberband 3.0.0. Defaults to `finer` (new engine).
+ - add `--wayland-configure-bounds` option
--- 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 93e051af23..e00993cfac 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -5570,6 +5570,14 @@ them.
``--wayland-app-id=<string>``
Set the client app id for Wayland-based video output methods (default: ``mpv``).
+``--wayland-configure-bounds=<yes|no>``
+ Controls whether or not mpv opts into the configure bounds event if sent by the
+ compositor (default: yes). This restricts the initial size of the mpv window to
+ a certain maximum size intended by the compositor. In most cases, this simply
+ just prevents the mpv window from being larger than the size of the monitor when
+ it first renders. This option will take precedence over any ``autofit`` or
+ ``geometry`` type settings if the configure bounds are used.
+
``--wayland-disable-vsync=<yes|no>``
Disable mpv's internal vsync for Wayland-based video output (default: no).
This is mainly useful for benchmarking wayland VOs when combined with