fdo-mirrors/xorg-xorgproto
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/xorg/proto/xorgproto.git synced 2026-05-08 03:08:09 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add GrabDevice and UngrabDevice XI2 requests.

Browse source
This commit is contained in:
Peter Hutterer 2009-04-10 17:31:05 +10:00
parent 1956df7e45
commit 8914a9a2a9
3 changed files with 136 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
XI2proto.h
View file

@ -55,8 +55,10 @@
#define X_XIQueryDevice 48
#define X_XISetDeviceFocus 49
#define X_XIGetDeviceFocus 50
#define X_XIGrabDevice 51
#define X_XIUngrabDevice 52
#define XI2REQUESTS (X_XIGetDeviceFocus - X_XIQueryDevicePointer + 1)
#define XI2REQUESTS (X_XIUngrabDevice - X_XIQueryDevicePointer + 1)
#define XI2EVENTS (XI_LASTEVENT + 1)
/*************************************************************************************
@ -488,6 +490,59 @@ typedef struct {
} xXIGetDeviceFocusReply;
#define sz_xXIGetDeviceFocusReply 32
/**********************************************************
*
* GrabDevice
*
*/
typedef struct {
uint8_t reqType;
uint8_t ReqType; /* Always X_XIGrabDevice */
uint16_t length;
Window grab_window;
Time time;
Cursor cursor;
uint16_t deviceid;
uint8_t grab_mode;
uint8_t paired_device_mode;
uint8_t owner_events;
uint8_t pad;
uint16_t mask_len;
} xXIGrabDeviceReq;
#define sz_xXIGrabDeviceReq 24
typedef struct {
uint8_t repType; /* input extension major opcode */
uint8_t RepType; /* Always X_XIGrabDevice */
uint16_t sequenceNumber;
uint32_t length;
uint8_t status;
uint8_t pad0;
uint16_t pad1;
uint32_t pad2;
uint32_t pad3;
uint32_t pad4;
uint32_t pad5;
uint32_t pad6;
} xXIGrabDeviceReply;
#define sz_xXIGrabDeviceReply 32
/**********************************************************
*
* UngrabDevice
*
*/
typedef struct {
uint8_t reqType;
uint8_t ReqType; /* Always X_XIUngrabDevice */
uint16_t length;
Time time;
uint16_t deviceid;
uint16_t pad;
} xXIUngrabDeviceReq;
#define sz_xXIUngrabDeviceReq 12
/*************************************************************************************
* *
* EVENTS *

79
XI2proto.txt
View file

@ -624,6 +624,85 @@ XI2. Clients should ignore this data.
Return the current focus window for the given device.
┌───
XIGrabDevice
deviceid: DEVICEID
grab-window: Window
owner-events: BOOL
grab-mode: { Synchronous, Asynchronous }
paired-device-mode: { Synchronous, Asynchronous }
time: TIMESTAMP or CurrentTime
mask_len: CARD16
masks: SETofEVENTMASK
▶
status: Success, AlreadyGrabbed, Frozen, InvalidTime, NotViewable
└───
This request actively grabs control of the specified input device. Further
input evens from this device are reported only to the grabbing client.
This request overides any previous active grab by this client for this
device.
The masks parameter specifies which events the client wishes to receive
while the device is grabbed.
If owner-events is False, input events generated from this device are
reported with respect to grab-window, and are only reported if selected by
being included in the event-list. If owner-events is True, then if a
generated event would normally be reported to this client, it is reported
normally, otherwise the event is reported with respect to the grab-window,
and is only reported if selected by being included in the event-list. For
either value of owner-events, unreported events are discarded.
If grab-mode is Asynchronous, device event processing continues normally.
If the device is currently frozen by this client, then processing of
device events is resumed. If grab-mode is Synchronous, the state of the
grabbed device (as seen by means of the protocol) appears to freeze,
and no further device events are generated by the server until the
grabbing client issues a releasing XIAllowEvents request or until the
device grab is released. Actual device input events are not lost while the
device is frozen; they are simply queued for later processing.
If the device is a slave device, the paired-device-mode is ignored.
Otherwise, if this device is a master device and paired-device-mode is
Asynchronous, event processing is unaffected by activation of the grab. If
this device is a master device and paired-device-mode is Synchronous, the
state of the master device paired with this device (as seen by means of the
protocol) appears to freeze, and no further events are generated by the
server until the grabbing client issues a releasing XIAllowEvents request
or until the device grab is released. Actual events are not lost while the
devices are frozen; they are simply queued for later processing.
This request fails and returns:
AlreadyGrabbed: If the device is actively grabbed by some other client.
NotViewable: If grab-window is not viewable.
InvalidTime: If the specified time is earlier than the last-grab-time for
the specified device or later than the current X server time.
Otherwise, the last-grab-time for the specified device is set
to the specified time and CurrentTime is replaced by the
current X server time.
Frozen: If the device is frozen by an active grab of another client.
To release a grab of an extension device, use UngrabDevice.
┌───
XIUngrabDevice
deviceid: DEVICEID
time: TIMESTAMP or CurrentTime
└───
Errors: Device
This request releases the device if this client has it actively grabbed
(from either XIGrabDevice, XIGrabDeviceKey or XIGrabDeviceButton) and
releases any queued events. If any devices were frozen by the grab,
XIUngrabDevice thaws them.
The request has no effect if the specified time is earlier
than the last-device-grab time or is later than the current server time.
This request generates DeviceFocusIn and DeviceFocusOut events.
An XIUngrabDevice is performed automatically if the event window for an
active device grab becomes not viewable.
8. Events:

2
XIproto.h
View file

@ -73,7 +73,7 @@ SOFTWARE.
#define IEVENTS 17 /* does NOT include generic events */
#define IERRORS 5
#define IREQUESTS 48
#define IREQUESTS 39
#define CLIENT_REQ 1