mirrors/wayland
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland.git synced 2026-02-17 22:05:58 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

protocol: add wl_keyboard.keys event

Browse source 
The compositor can use this event together with the keymap and modifiers
event to replace the client's view of the XKB state without having to
generate synthetic leave, enter, or key events that might cause
unintended side effects.

A compositor might use this in the following situations:

- If the user disconnects a physical keyboard that currently has keys
  pressed, the compositor might send a keys event with an empty array.
- If the user has multiple physical keyboards with different keymaps
  connected and switches from one to the other, the compositor might use
  this event when sending the new keymap to the client.

Signed-off-by: Julian Orth <ju.orth@gmail.com>
This commit is contained in:
Julian Orth 2024-07-23 14:34:26 +02:00
parent fa1811ce3e
commit bd42ea82fc
1 changed files with 22 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

26
protocol/wayland.xml
View file

@ -1880,7 +1880,7 @@
</event>
</interface>
<interface name="wl_seat" version="9">
<interface name="wl_seat" version="10">
<description summary="group of input devices">
A seat is a group of keyboards, pointer and touch devices. This
object is published as a global during start up, or when such a
@ -2013,7 +2013,7 @@
</interface>
<interface name="wl_pointer" version="9">
<interface name="wl_pointer" version="10">
<description summary="pointer input device">
The wl_pointer interface represents one or more input devices,
such as mice, which control the pointer location and pointer_focus
@ -2426,7 +2426,7 @@
</event>
</interface>
<interface name="wl_keyboard" version="9">
<interface name="wl_keyboard" version="10">
<description summary="keyboard input device">
The wl_keyboard interface represents one or more keyboards
associated with a seat.
@ -2461,6 +2461,10 @@
From version 7 onwards, the fd must be mapped with MAP_PRIVATE by
the recipient, as MAP_SHARED may fail.
From version 10 onwards, if the wl_keyboard has an active surface
immediately before this event, the compositor must send modifiers and
keys events immediately after this event.
</description>
<arg name="format" type="uint" enum="keymap_format" summary="keymap format"/>
<arg name="fd" type="fd" summary="keymap file descriptor"/>
@ -2588,9 +2592,23 @@
<arg name="delay" type="int"
summary="delay in milliseconds since key down until repeating starts"/>
</event>
<!-- Version 10 additions -->
<event name="keys" since="10">
<description summary="logically down keys">
Notifies the client that the set of logically down keys has changed.
In the wl_keyboard logical state, this event replaces the keys currently
logically down. The compositor must not send this event if the
wl_keyboard did not have an active surface immediately before this
event.
</description>
<arg name="keys" type="array" summary="the keys currently logically down"/>
</event>
</interface>
<interface name="wl_touch" version="9">
<interface name="wl_touch" version="10">
<description summary="touchscreen input device">
The wl_touch interface represents a touchscreen
associated with a seat.