From fce1d3031837ae1562311268a854fc03e441c53d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jonas=20=C3=85dahl?= Date: Thu, 12 Nov 2020 16:07:22 +0100 Subject: xdg-shell: Clarify that geometry doesn't automatically change MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- stable/xdg-shell/xdg-shell.xml | 17 ++++++++++++----- 1 file 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. -- cgit v1.2.1