From 43a09b1577ce54a42b46f8b6182306633a695956 Mon Sep 17 00:00:00 2001 From: Jonas Ådahl Date: Mon, 8 May 2017 22:23:17 +0800 Subject: xdg-shell/surface: Add note about window position and geometry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A client might want to change the window geometry without wanting the window to be moved, for example when changing the width of the border. Point out that the compositor should treat the (x,y) coordinate of the geometry as the top-left corner of the window, and not change the position of the window as it appears on the screen if the (x,y) coordinate changes. Signed-off-by: Jonas Ådahl Reviewed-By: Mike Blumenkrantz --- stable/xdg-shell/xdg-shell.xml | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'stable/xdg-shell') diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index 3d19f62..c7dd6dd 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -445,6 +445,11 @@ The window geometry is double buffered, and will be applied at the time wl_surface.commit of the corresponding wl_surface is called. + When maintaining a position, the compositor should treat the (x, y) + coordinate of the window geometry as the top left corner of the window. + A client changing the (x, y) window geometry coordinate should in + general not alter the position of the window. + Once the window geometry of the surface is set, it is not possible to unset it, and it will remain the same until set_window_geometry is called again, even if a new subsurface or buffer is attached. -- cgit v1.2.3