summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2023-01-26 14:21:58 -0600
committerDudemanguy <random342@airmail.cc>2023-01-30 03:59:40 +0000
commitda81a6d5322f6fd1665d06f72dba2a809bfa240b (patch)
tree17c24417646211598ad36d2e0484db1070be1e36 /DOCS
parentadc04dbba042a4119a5ec59adf4d839dbf33128f (diff)
downloadmpv-da81a6d5322f6fd1665d06f72dba2a809bfa240b.tar.bz2
mpv-da81a6d5322f6fd1665d06f72dba2a809bfa240b.tar.xz
wayland: add auto choice to wayland-configure-bounds
Previously, this defaulted to yes and configure-bounds from the compositor would always apply. In the case where the user explicitly set autofit or geometry, this could be confusing because configure-bounds would take precedence over it. Instead, let's add an auto choice and make that the default. If we detect that the option is on auto and that there is autofit/geometry being set, then ignore the event. This should be more intuitive since someone who bothers to explicitly set mpv's geometry would naturally expect that geometry to actually apply.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst8
1 files changed, 4 insertions, 4 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 7e99b2a5d5..442a7ff3e1 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -5610,13 +5610,13 @@ them.
``--wayland-app-id=<string>``
Set the client app id for Wayland-based video output methods (default: ``mpv``).
-``--wayland-configure-bounds=<yes|no>``
+``--wayland-configure-bounds=<auto|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
+ compositor (default: auto). 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.
+ it first renders. With the default value of ``auto``, configure-bounds will
+ silently be ignored if any ``autofit`` or ``geometry`` type option is also set.
``--wayland-content-type=<auto|none|photo|video|game>``
If supported by the compositor, mpv will send a hint using the content-type