diff options
author | Xaver Hugl <xaver.hugl@kde.org> | 2025-07-17 18:18:17 +0200 |
---|---|---|
committer | Simon Ser <contact@emersion.fr> | 2025-08-03 11:38:49 +0000 |
commit | c61399a0cc6947131f8f8a181bcbdca9d14747c4 (patch) | |
tree | cc4931af1ec275b4d96c3f86c0095f49f6752e76 | |
parent | 46f46863b7b5ac8d9c5bcdb167b57ae803d064ac (diff) |
xdg-shell: warn about putting UI outside of window geometry
There should only be decoration outside of it, no functional UI elements. This
is especially important on some compositors that clip windows to their window
geometry in some situations (like when it's in a tile).
Signed-off-by: Xaver Hugl <xaver.hugl@kde.org>
-rw-r--r-- | stable/xdg-shell/xdg-shell.xml | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index fb7b8b4..39ecf8a 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -514,7 +514,10 @@ The window geometry of a surface is its "visible bounds" from the user's perspective. Client-side decorations often have invisible portions like drop-shadows which should be ignored for the - purposes of aligning, placing and constraining windows. + purposes of aligning, placing and constraining windows. Note that + in some situations, compositors may clip rendering to the window + geometry, so the client should avoid putting functional elements + outside of it. The window geometry is double-buffered state, see wl_surface.commit. |