diff options
| -rw-r--r-- | stable/xdg-shell/xdg-shell.xml | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index 34e3a20..dc70c7a 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -728,8 +728,11 @@ </entry> <entry name="fullscreen" value="2" summary="the surface is fullscreen"> <description summary="the surface is fullscreen"> - The surface is fullscreen. The window geometry specified in the configure - event must be obeyed by the client. + The surface is fullscreen. The window geometry specified in the + configure event is a maximum; the client cannot resize beyond it. For + a surface to cover the whole fullscreened area, the geometry + dimensions must be obeyed by the client. For more details, see + xdg_toplevel.set_fullscreen. </description> </entry> <entry name="resizing" value="3" summary="the surface is being resized"> @@ -888,7 +891,7 @@ After requesting that the surface should be fullscreened, the compositor will respond by emitting a configure event with the - "fullscreen" state and the required window geometry. The client must + "fullscreen" state and the fullscreen window geometry. The client must also acknowledge the configure when committing the new content (see ack_configure). @@ -899,7 +902,14 @@ If the surface doesn't cover the whole output, the compositor will position the surface in the center of the output and compensate with - black borders filling the rest of the output. + with border fill covering the rest of the output. The content of the + border fill is undefined, but should be assumed to be in some way that + attempts to blend into the surrounding area (e.g. solid black). + + If the fullscreened surface is not opaque, the compositor must make + sure that other screen content not part of the same surface tree (made + up of subsurfaces, popups or similarly coupled surfaces) are not + visible below the fullscreened surface. </description> <arg name="output" type="object" interface="wl_output" allow-null="true"/> </request> |