diff options
author | Drew DeVault <sir@cmpwn.com> | 2018-03-18 13:58:01 -0400 |
---|---|---|
committer | Drew DeVault <sir@cmpwn.com> | 2018-03-27 18:50:09 -0400 |
commit | 88eec637a44ede8b521c2aa44d0196c99dd5a0e3 (patch) | |
tree | b0ce49fcee9fa76d5a394b31e446e53339cbddc5 /protocol | |
parent | 1628730b09448c596c14f948fce53677980337ce (diff) |
Address feedback
Diffstat (limited to 'protocol')
-rw-r--r-- | protocol/wlr-layer-shell-unstable-v1.xml | 93 |
1 files changed, 26 insertions, 67 deletions
diff --git a/protocol/wlr-layer-shell-unstable-v1.xml b/protocol/wlr-layer-shell-unstable-v1.xml index 29ba9dd4..285c9b8f 100644 --- a/protocol/wlr-layer-shell-unstable-v1.xml +++ b/protocol/wlr-layer-shell-unstable-v1.xml @@ -61,7 +61,6 @@ <entry name="role" value="0" summary="wl_surface has another role"/> <entry name="invalid_layer" value="1" summary="layer value is invalid"/> <entry name="already_constructed" value="2" summary="wl_surface has a buffer attached or committed"/> - <entry name="request_denied" value="4" summary="the compositor has denied your request to use this layer"/> </enum> <enum name="layer"> @@ -87,11 +86,9 @@ are designed to be rendered as a layer of a stacked desktop-like environment. - Layer surface state (anchor, exclusive zone, margin) is double-buffered. - Protocol requests modify the pending state, as opposed to the current - state in use by the compositor. The wl_surface.commit request atomically - applies all pending state, replacing the current state. After commit, the - new pending state is as documented for each related request. + Layer surface state (anchor, exclusive zone, margin, interactivity) is + double-buffered, and will be applied at the time wl_surface.commit of the + corresponding wl_surface is called. </description> <request name="set_anchor"> @@ -129,12 +126,31 @@ point on the output, in pixels. Setting this value for edges you are not anchored to has no effect. + The exclusive zone includes the margin. + Margin is double-buffered, see wl_surface.commit. </description> - <arg name="top" type="uint"/> - <arg name="right" type="uint"/> - <arg name="bottom" type="uint"/> - <arg name="left" type="uint"/> + <arg name="top" type="int"/> + <arg name="right" type="int"/> + <arg name="bottom" type="int"/> + <arg name="left" type="int"/> + </request> + + <request name="set_keyboard_interactivity"> + <description summary="requests keyboard events"> + Set to 1 to request that the seat send keyboard events to this layer + surface. For layers below the shell surface layer, the seat will use + normal focus semantics. For layers above the shell surface layers, the + seat will always give exclusive keyboard focus to the top-most layer + which has keyboard interactivity set to true. + + Layer surfaces receive pointer, touch, and tablet events normally. If + you do not want to receive them, set the input region on your surface + to an empty region. + + Events is double-buffered, see wl_surface.commit. + </description> + <arg name="keyboard_interactivity" type="uint"/> </request> <request name="get_popup"> @@ -150,15 +166,6 @@ <arg name="popup" type="object" interface="xdg_popup"/> </request> - <request name="get_input"> - <description summary="obtain a layer input for this layer surface"> - This creates a layer input for this layer surface. This can be used to - control input semantics for the layer surface on the specified wl_seat. - </description> - <arg name="id" type="new_id" interface="zwlr_layer_input_v1"/> - <arg name="seat" type="object" interface="wl_seat"/> - </request> - <request name="ack_configure"> <description summary="ack a configure event"> When a configure event is received, if a client commits the @@ -228,52 +235,4 @@ <entry name="right" value="8" summary="the right edge of the anchor rectangle"/> </enum> </interface> - - <interface name="zwlr_layer_input_v1" version="1"> - <description summary="layer surface input configuration object"> - Clients can use this interface to specify input semantics for a layer - surface on a given seat. By default, layer surfaces are considered - non-interactive by seats, and will not participate in their focus - semantics or receive input events for them. - - Input state is double-buffered. Protocol requests modify the pending - state, as opposed to the current state in use by the compositor. The - wl_surface.commit request for the associated layer surface atomically - applies all pending state, replacing the current state. After commit, the - new pending state is as documented for each related request. - </description> - - <request name="set_events"> - <description summary="set input events to receive"> - Requests that the seat send input events for the specified input devices - to this layer surface. - - Positional events (pointer and touch) will only be sent if the layer - surface is the top-most interactive surface, and only when the position - of these events are relative to the surface. Enter and leave events will - be signalled normally in these cases. - - Keyboard events will treat the layer surface as the only focused surface - on the seat. Upon requesting keyboard events, the layer surface will - receive a keyboard enter event. A leave event is signalled when it - invokes set_events again without keyboard events specified. - - Events is double-buffered, see wl_surface.commit. - </description> - <arg name="events" type="uint" enum="input_device"/> - </request> - - <request name="destroy" type="destructor"> - <description summary="destroy the layer_input"> - This request destroys the layer input. - </description> - </request> - - <enum name="input_device" bitfield="true"> - <entry name="pointer" value="1" summary="wl_pointer devices"/> - <entry name="keyboard" value="2" summary="wl_keyboard devices"/> - <entry name="touch" value="4" summary="wl_touch devices"/> - <entry name="tablet" value="8" summary="zwp_tablet and zwp_tablet_tool devices"/> - </enum> - </interface> </protocol> |