diff --git a/unstable/wlr-layer-shell-unstable-v1.xml b/unstable/wlr-layer-shell-unstable-v1.xml index fa67001..2ff86e8 100644 --- a/unstable/wlr-layer-shell-unstable-v1.xml +++ b/unstable/wlr-layer-shell-unstable-v1.xml @@ -25,7 +25,7 @@ THIS SOFTWARE. - + Clients can use this interface to assign the surface_layer role to wl_surfaces. Such surfaces are assigned to a "layer" of the output and @@ -92,9 +92,43 @@ are not affected. + + + + + + This event indicates that one or more new outputs have been + created. All clients must send an ack_new_output request in response + to this event. If a client wishes to create a new layer surface in + response to the new output(s), it must make an ack_new_output request + with the provided serial after creating any new layer surfaces using + the get_layer_surface request and before the first commit on any of + the new surfaces. If the client does not wish to create a new layer + surface, it should ack immediately. + + This allows the compositor to wait until new layer surfaces are ready + before rendering the first frame of new outputs, avoiding a race that + could cause imperfect frames. + + + + + + + This request informs the server that the client has created all + layer surfaces it intends to create in response to the new output(s). + These new layer surfaces are associated only with this ack sequence + and do *not* carry over to following ack sequences should any occur + before the first commit on the surfaces. + + If the client receives multiple new_output events before it + can respond to one, it only has to ack the last new_output event. + + + - + An interface that may be implemented by a wl_surface, for surfaces that are designed to be rendered as a layer of a stacked desktop-like