xdg-shell: Add suspended toplevel state
Add a toplevel state to indicate that surface repaints have been
suspended. This may arise due to occlusion, output power state, etc.
In this state, clients can choose to take meaningful action such as
suspending any processing which would drive a repaint loop, or
communicating to the active browser tab that the tab is not
system-visible, or any other action that would be taken by a client not
expecting to repaint until further notice.
cf. discussion in wayland/wayland-protocols!99
Signed-off-by: Daniel Stone <daniels@collabora.com>
Daniel Stone
10 months ago
| 28 | 28 | DEALINGS IN THE SOFTWARE. |
| 29 | 29 | </copyright> |
| 30 | 30 | |
| 31 | <interface name="xdg_wm_base" version="5"> | |
| 31 | <interface name="xdg_wm_base" version="6"> | |
| 32 | 32 | <description summary="create desktop-style surfaces"> |
| 33 | 33 | The xdg_wm_base interface is exposed as a global object enabling clients |
| 34 | 34 | to turn their wl_surfaces into windows in a desktop environment. It |
| 121 | 121 | </event> |
| 122 | 122 | </interface> |
| 123 | 123 | |
| 124 | <interface name="xdg_positioner" version="5"> | |
| 124 | <interface name="xdg_positioner" version="6"> | |
| 125 | 125 | <description summary="child surface positioner"> |
| 126 | 126 | The xdg_positioner provides a collection of rules for the placement of a |
| 127 | 127 | child surface relative to a parent surface. Rules can be defined to ensure |
| 406 | 406 | </request> |
| 407 | 407 | </interface> |
| 408 | 408 | |
| 409 | <interface name="xdg_surface" version="5"> | |
| 409 | <interface name="xdg_surface" version="6"> | |
| 410 | 410 | <description summary="desktop user interface surface base interface"> |
| 411 | 411 | An interface that may be implemented by a wl_surface, for |
| 412 | 412 | implementations that provide a desktop-style user interface. |
| 614 | 614 | |
| 615 | 615 | </interface> |
| 616 | 616 | |
| 617 | <interface name="xdg_toplevel" version="5"> | |
| 617 | <interface name="xdg_toplevel" version="6"> | |
| 618 | 618 | <description summary="toplevel surface"> |
| 619 | 619 | This interface defines an xdg_surface role which allows a surface to, |
| 620 | 620 | among other things, set window-like properties such as maximize, |
| 886 | 886 | considered to be adjacent to another part of the tiling grid. |
| 887 | 887 | </description> |
| 888 | 888 | </entry> |
| 889 | <entry name="suspended" value="9" since="6"> | |
| 890 | <description summary="surface repaint is suspended"> | |
| 891 | The surface is currently not ordinarily being repainted; for | |
| 892 | example because its content is occluded by another window, or its | |
| 893 | outputs are switched off due to screen locking. | |
| 894 | </description> | |
| 895 | </entry> | |
| 889 | 896 | </enum> |
| 890 | 897 | |
| 891 | 898 | <request name="set_max_size"> |
| 1184 | 1191 | </event> |
| 1185 | 1192 | </interface> |
| 1186 | 1193 | |
| 1187 | <interface name="xdg_popup" version="5"> | |
| 1194 | <interface name="xdg_popup" version="6"> | |
| 1188 | 1195 | <description summary="short-lived, popup surfaces for menus"> |
| 1189 | 1196 | A popup surface is a short-lived, temporary surface. It can be used to |
| 1190 | 1197 | implement for example menus, popovers, tooltips and other similar user |