aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Ådahl <jadahl@gmail.com>2020-11-12 16:07:22 +0100
committerSimon Ser <contact@emersion.fr>2023-04-04 11:14:27 +0000
commitfce1d3031837ae1562311268a854fc03e441c53d (patch)
treed53f9c696aa6dfcce3e60a5b921237b1f5b1d6b2
parent275fce4af9b6008a372933dfa5109553e6348dd1 (diff)
xdg-shell: Clarify that geometry doesn't automatically change
The spec says that When applied, the effective window geometry will be the set window geometry clamped to the bounding rectangle of the combined geometry of the surface of the xdg_surface and the associated subsurfaces. Thus, a client cannot assume the geometry will adapt to any subsequent changes to any conditions that constrained the geometry. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
-rw-r--r--stable/xdg-shell/xdg-shell.xml17
1 files changed, 12 insertions, 5 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index 6eb0a67..835db07 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -532,11 +532,18 @@
The arguments are given in the surface-local coordinate space of
the wl_surface associated with this xdg_surface.
- The width and height must be greater than zero. Setting an invalid size
- will raise an invalid_size error. When applied, the effective window
- geometry will be the set window geometry clamped to the bounding
- rectangle of the combined geometry of the surface of the xdg_surface and
- the associated subsurfaces.
+ When applied, the effective window geometry will be the set window
+ geometry clamped to the bounding rectangle of the combined
+ geometry of the surface of the xdg_surface and the associated
+ subsurfaces.
+
+ The effective geometry will not be recalculated unless a new call to
+ set_window_geometry is done and the new pending surface state is
+ subsequently applied.
+
+ The width and height of the effective window geometry must be
+ greater than zero. Setting an invalid size will raise an
+ invalid_size error.
</description>
<arg name="x" type="int"/>
<arg name="y" type="int"/>