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>
This commit is contained in:
Xaver Hugl 2025-07-17 18:18:17 +02:00 committed by Simon Ser
parent 46f46863b7
commit c61399a0cc

View file

@ -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.