The purpose of this protocol is to enable the creation of different desktop-interface windows like panels, backgrounds, docks, lockscreens, etc. It also aims to allow the creation of full-blown DEs using Wayfire. Note that in contrast to some other efforts to create a similar protocol, such as wlr-layer-shell, this isn't a new "shell" for giving a role to wl_surfaces. This protocol can be used with any type of toplevel surface (xdg_toplevel, xdg_toplevel_v6, etc.) to give them to the corresponding WM role. Assign the given role to the given surface and add it to the given output. A client can specify a null output, in which case the compositor will assign the surface to the focused output, if any such output. The role cannot be changed later, and neither can the surface be moved to a different output, except by the compositor. Represents a single output. Each output is managed independently from the others. Panels are always rendered on top, even above fullscreen windows. If autohide is 1, the event indicates that the panels should hide itself, by for example unmapping or sliding outside of the output. If autohide is 0, this means that the reason for the last request with autohide == 1 is no longer valid, i.e the panels can show themselves. The output_hide_panels can be called multiple times with autohide = 1, and the panel should show itself only when it has received a matching number of events with autohide = 0 Request the compositor to not render the output, so the output usually is cleared to black color. To enable output rendering again, call inhibit_output_done Stop inhibiting the output. This must be called as many times as inhibit_output was called to actually uninhibit rendering. The inhibit/inhibit_done requests can be called multiple times, even from different apps, so don't assume that a call to inhibit_done would always mean actually starting the rendering process. Represents a surface with a specific WM role. It belongs to the output which it was created for. Sets the position on the screen where the compositor should position the view. Can be reset by specifying anchor 0. If not set, the compositor will assume manual positioning via the configure request. If one anchor edge is provided, the wm surface is "stuck" to that edge. If two anchor edges are provided, the wm surface is considered anchored to the corner of the screen between them. Any other anchor edge configuration is considered invalid. Set the offset from the anchored edges to the wm surface. This is an alternative to the configure request. Using both will result in undefined results. Margin has effect only for edges the wm surface is anchored to. Sets how the wm surface will interact with keyboard focus. Setting no_focus means that the surface will never receive keyboard focus, click_to_focus means normal focus semantics (i.e what you expect from "normal" windows), and exclusive focus means that no other window can get keyboard focus. Request the compositor to reserve the given amount of pixels for the wm surface(like STRUTS in X11). This has effect only if the surface is anchored to a single edge. Margin doesn't affect exclusive zone in any way.