summaryrefslogtreecommitdiff
path: root/man/XIQueryDevice.txt
diff options
context:
space:
mode:
Diffstat (limited to 'man/XIQueryDevice.txt')
-rw-r--r--man/XIQueryDevice.txt30
1 files changed, 29 insertions, 1 deletions
diff --git a/man/XIQueryDevice.txt b/man/XIQueryDevice.txt
index 6b5a622..e5e8251 100644
--- a/man/XIQueryDevice.txt
+++ b/man/XIQueryDevice.txt
@@ -100,7 +100,8 @@ DESCRIPTION
The type field specifies the type of the input class.
Currently, the following types are defined:
- XIKeyClass, XIButtonClass, XIValuatorClass, XIScrollClass
+ XIKeyClass, XIButtonClass, XIValuatorClass, XIScrollClass,
+ XITouchClass
In the future, additional types may be added. Clients are
required to ignore unknown input classes.
@@ -231,6 +232,33 @@ DESCRIPTION
the emulation of XI_Motion events when the driver submits
legacy scroll button events.
+ typedef struct
+ {
+ int type;
+ int sourceid;
+ int mode;
+ int num_touches;
+ } XITouchClassInfo;
+
+ A device may have zero or one XITouchClassInfo, denoting
+ multi-touch capability on the device. A device with a XITouchClassInfo
+ may send TouchBegin, TouchUpdate, TouchEnd and TouchOwnership events.
+
+ The mode field is either XIDirectTouch for direct-input touch devices
+ such as touchscreens or XIDependentTouch for indirect input devices such
+ as touchpads. For XIDirectTouch devices, touch events are sent to window
+ at the position the touch occured. For XIDependentTouch devices, touch
+ events are sent to the window at the position of the device's sprite.
+
+ The num_touches field defines the maximum number of simultaneous touches
+ the device supports. A num_touches of 0 means the maximum number of
+ simultaneous touches is undefined or unspecified. This field should be
+ used as a guide only, devices will lie about their capabilities.
+
+ A device with an XITouchClassInfo may still send pointer events. The
+ valuators must be defined with the respective XIValuatorClass
+ classes. A valuator may send both pointer and touch-events.
+
XIQueryDevice can generate a BadDevice error.
XIFreeDeviceInfo frees the information returned by