xinput: struct FeedbackCtl: full support
[free-sw/xcb/proto] / src / xinput.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <!--
3 Copyright (C) 2006 Peter Hutterer
4 Copyright (C) 2013 Daniel Martin
5 All Rights Reserved.
6
7 Permission is hereby granted, free of charge, to any person obtaining a copy
8 of this software and associated documentation files (the "Software"), to deal
9 in the Software without restriction, including without limitation the rights
10 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 copies of the Software, and to permit persons to whom the Software is
12 furnished to do so, subject to the following conditions:
13
14 The above copyright notice and this permission notice shall be included in all
15 copies or substantial portions of the Software.
16
17 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
21 ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23
24 Except as contained in this notice, the names of the authors or their
25 institutions shall not be used in advertising or otherwise to promote the
26 sale, use or other dealings in this Software without prior written
27 authorization from the authors.
28 -->
29
30 <!-- Specifications:
31      http://cgit.freedesktop.org/xorg/proto/inputproto/tree/specs/XIproto.txt
32      http://cgit.freedesktop.org/xorg/proto/inputproto/tree/specs/XI2proto.txt
33 -->
34
35 <!-- TODO: Things which need to be done for full XInput support
36         but cannot be done now ( August 18, 2014 ) with the current feature-set
37         of the xml and the generator:
38
39 *****
40
41 replace "uninterpreted_data" or similar constructs
42 with a semantic that shows how to interpret this data.
43 This requires enhancements to the xml-schema and generator such as union with selector.
44
45 This will, e.g., be necessary for automatically generated byte-order conversion code,
46 which will, e.g., be necessary for server-side xcb.
47
48 This affects the following:
49 * QueryDeviceState reply field "classes" ( structs InputState, ... )
50 * GetDeviceControl reply field "control"  ( structs DeviceState, ... )
51 * ChangeDeviceControl request field "control" ( structs ChangeDeviceControl, ... )
52 * XIChangeHierarchy request field "changes" ( structs  HierarchyChange, ... )
53 * struct XIDeviceInfo field "classes" ( structs DeviceClass, ... )
54 * SendExtensionEvent member "events"
55
56 *****
57
58 xml and generator have to support <popcount> of all members of a list
59
60 This is needed for the following XI2-events ( and eventcopies thereof )
61         KeyPress
62         ButtonPress
63         RawKeyPress
64         RawKeyPress
65         RawButtonPress
66         TouchBegin
67         RawTouchBegin
68
69 *****
70
71 xml and generator should support
72 switch-case similar to switch-bitcase.
73
74 (and maybe: variable sized unions with a mechanism to define
75 which union-field is selected.)
76
77 One of these features is needed for the InputInfo type
78 which is used by request "ListInputDevices" for the list "input_infos".
79
80 *****
81
82 Parametrized structs
83
84 This is needed for being able to use the value of the field
85 "num_axes" of the GetDeviceMotionEvents-reply
86 in struct DeviceTimeCoord.
87
88 *****
89
90 -->
91
92
93 <xcb header="xinput" extension-xname="XInputExtension" extension-name="Input"
94      major-version="2" minor-version="3">
95     <import>xfixes</import>
96     <import>xproto</import>
97
98     <!-- ⋅⋅⋅ Types (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
99
100     <typedef oldname="CARD32" newname="EventClass" />
101     <typedef oldname="CARD8"  newname="KeyCode" />
102
103     <!-- ⋅⋅⋅ Types (v2.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
104
105     <typedef oldname="CARD16" newname="DeviceId" />
106     <typedef oldname="INT32"  newname="FP1616" />
107
108     <struct name="FP3232">
109         <field type="INT32"  name="integral" />
110         <field type="CARD32" name="frac" />
111     </struct>
112
113     <!-- ⋅⋅⋅ Requests (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
114
115     <!-- GetExtensionVersion -->
116
117     <request name="GetExtensionVersion" opcode="1">
118         <field type="CARD16" name="name_len" />
119         <pad bytes="2" />
120         <list type="char" name="name">
121             <fieldref>name_len</fieldref>
122         </list>
123         <reply>
124             <field type="CARD8"  name="xi_reply_type" />
125             <field type="CARD16" name="server_major" />
126             <field type="CARD16" name="server_minor" />
127             <field type="BOOL"   name="present" />
128             <pad bytes="19" />
129         </reply>
130     </request>
131
132     <!-- ListInputDevices -->
133
134     <enum name="DeviceUse">
135         <item name="IsXPointer">           <value>0</value> </item>
136         <item name="IsXKeyboard">          <value>1</value> </item>
137         <item name="IsXExtensionDevice">   <value>2</value> </item>
138         <item name="IsXExtensionKeyboard"> <value>3</value> </item>
139         <item name="IsXExtensionPointer">  <value>4</value> </item>
140     </enum>
141
142     <enum name="InputClass">
143         <item name="Key">       <value>0</value> </item>
144         <item name="Button">    <value>1</value> </item>
145         <item name="Valuator">  <value>2</value> </item>
146         <item name="Feedback">  <value>3</value> </item>
147         <item name="Proximity"> <value>4</value> </item>
148         <item name="Focus">     <value>5</value> </item>
149         <item name="Other">     <value>6</value> </item>
150         <!--
151                value Attach=7 is still contained in XI.h as "#define AttachClass"
152                but it was never transmitted over the protocol.
153                (It was used to tag a fake class created by libXi).
154
155                Even the creation of that fake class has been dropped
156                from libXi in 2009 by the following change:
157                http://cgit.freedesktop.org/xorg/lib/libXi/commit/?id=62858c426e6de1b99df660251737233afd335302
158
159                <item name="Attach">    <value>7</value> </item>
160         -->
161     </enum>
162
163     <enum name="ValuatorMode">
164         <item name="Relative"> <value>0</value> </item>
165         <item name="Absolute"> <value>1</value> </item>
166     </enum>
167
168     <struct name="DeviceInfo">
169         <field type="ATOM"  name="device_type" />
170         <field type="CARD8" name="device_id" />
171         <field type="CARD8" name="num_class_info" />
172         <field type="CARD8" name="device_use" enum="DeviceUse" />
173         <pad bytes="1" />
174     </struct>
175
176     <struct name="AxisInfo">
177         <field type="CARD32" name="resolution" />
178         <field type="INT32"  name="minimum" />
179         <field type="INT32"  name="maximum" />
180     </struct>
181
182     <struct name="InputInfo">
183         <field type="CARD8" name="class_id" enum="InputClass" />
184         <field type="CARD8" name="len" />
185         <switch name="info">
186             <fieldref>class_id</fieldref>
187             <case name="key">
188                 <enumref ref="InputClass">Key</enumref>
189                 <field type="KeyCode" name="min_keycode" />
190                 <field type="KeyCode" name="max_keycode" />
191                 <field type="CARD16"  name="num_keys" />
192                 <pad bytes="2" />
193             </case>
194             <case name="button">
195                 <enumref ref="InputClass">Button</enumref>
196                 <field type="CARD16"    name="num_buttons" />
197             </case>
198             <case name="valuator">
199                 <enumref ref="InputClass">Valuator</enumref>
200                 <field type="CARD8"   name="axes_len" />
201                 <field type="CARD8"   name="mode" enum="ValuatorMode" />
202                 <field type="CARD32"  name="motion_size" />
203                 <list type="AxisInfo" name="axes">
204                     <fieldref>axes_len</fieldref>
205                 </list>
206             </case>
207         </switch>
208     </struct>
209
210     <request name="ListInputDevices" opcode="2">
211         <reply>
212             <field type="CARD8" name="xi_reply_type" />
213             <field type="CARD8" name="devices_len" />
214             <pad bytes="23" />
215             <list type="DeviceInfo" name="devices">
216                 <fieldref>devices_len</fieldref>
217             </list>
218             <list type="InputInfo" name="infos">
219                 <sumof ref="devices">
220                         <fieldref>num_class_info</fieldref>
221                 </sumof>
222             </list>
223             <list type="STR" name="names">
224                 <fieldref>devices_len</fieldref>
225             </list>
226             <pad align="4" />
227         </reply>
228     </request>
229
230     <!-- OpenDevice -->
231
232     <struct name="InputClassInfo">
233         <field type="CARD8" name="class_id" enum="InputClass" />
234         <field type="CARD8" name="event_type_base" />
235     </struct>
236
237     <request name="OpenDevice" opcode="3">
238         <field type="CARD8" name="device_id" />
239         <pad bytes="3" />
240         <reply>
241             <field type="CARD8" name="xi_reply_type" />
242             <field type="CARD8" name="num_classes" />
243             <pad bytes="23" />
244             <list type="InputClassInfo" name="class_info">
245                 <fieldref>num_classes</fieldref>
246             </list>
247             <pad align="4" />
248         </reply>
249     </request>
250
251     <!-- CloseDevice -->
252
253     <request name="CloseDevice" opcode="4">
254         <field type="CARD8" name="device_id" />
255         <pad bytes="3" />
256     </request>
257
258     <!-- SetDeviceMode -->
259
260     <request name="SetDeviceMode" opcode="5">
261         <field type="CARD8" name="device_id" />
262         <field type="CARD8" name="mode" enum="ValuatorMode" />
263         <pad bytes="2" />
264         <reply>
265             <field type="CARD8" name="xi_reply_type" />
266             <!-- values for status: 0: Success, 1: AlreadyGrabbed -->
267             <field type="CARD8" name="status" enum="GrabStatus" />
268             <pad bytes="23" />
269         </reply>
270     </request>
271
272     <!-- SelectExtensionEvent -->
273
274     <request name="SelectExtensionEvent" opcode="6">
275         <field type="WINDOW" name="window" />
276         <field type="CARD16" name="num_classes" />
277         <pad bytes="2" />
278         <list type="EventClass" name="classes">
279             <fieldref>num_classes</fieldref>
280         </list>
281     </request>
282
283     <!-- GetSelectedExtensionEvents -->
284
285     <request name="GetSelectedExtensionEvents" opcode="7">
286         <field type="WINDOW" name="window" />
287         <reply>
288             <field type="CARD8"  name="xi_reply_type" />
289             <field type="CARD16" name="num_this_classes" />
290             <field type="CARD16" name="num_all_classes" />
291             <pad bytes="20" />
292             <list type="EventClass" name="this_classes">
293                 <fieldref>num_this_classes</fieldref>
294             </list>
295             <list type="EventClass" name="all_classes">
296                 <fieldref>num_all_classes</fieldref>
297             </list>
298         </reply>
299     </request>
300
301     <!-- ChangeDeviceDontPropagateList -->
302
303     <enum name="PropagateMode">
304         <item name="AddToList">      <value>0</value> </item>
305         <item name="DeleteFromList"> <value>1</value> </item>
306     </enum>
307
308     <request name="ChangeDeviceDontPropagateList" opcode="8">
309         <field type="WINDOW" name="window" />
310         <field type="CARD16" name="num_classes" />
311         <field type="CARD8"  name="mode" enum="PropagateMode" />
312         <pad bytes="1" />
313         <list type="EventClass" name="classes">
314             <fieldref>num_classes</fieldref>
315         </list>
316     </request>
317
318     <!-- GetDeviceDontPropagateList -->
319
320     <request name="GetDeviceDontPropagateList" opcode="9">
321         <field type="WINDOW" name="window" />
322         <reply>
323             <field type="CARD8"  name="xi_reply_type" />
324             <field type="CARD16" name="num_classes" />
325             <pad bytes="22" />
326             <list type="EventClass" name="classes">
327                 <fieldref>num_classes</fieldref>
328             </list>
329         </reply>
330     </request>
331
332     <!-- GetDeviceMotionEvents -->
333
334     <struct name="DeviceTimeCoord">
335         <field type="TIMESTAMP" name="time" />
336         <!-- Uninterpreted: list (axisvalues) of INT32,
337                             length is num_axes from GetDeviceMotionEvents -->
338     </struct>
339
340     <request name="GetDeviceMotionEvents" opcode="10">
341         <field type="TIMESTAMP" name="start" />
342         <field type="TIMESTAMP" name="stop" altenum="Time" />
343         <field type="CARD8"     name="device_id" />
344         <pad bytes="3"/>
345         <reply>
346             <field type="CARD8"  name="xi_reply_type" />
347             <field type="CARD32" name="num_events" />
348             <field type="CARD8"  name="num_axes" />
349             <field type="CARD8"  name="device_mode" enum="ValuatorMode" />
350             <pad bytes="18" />
351             <!-- Uninterpreted: list (events) of DeviceTimeCoord structures -->
352         </reply>
353     </request>
354
355     <!-- ChangeKeyboardDevice -->
356
357     <request name="ChangeKeyboardDevice" opcode="11">
358         <field type="CARD8" name="device_id" />
359         <pad bytes="3" />
360         <reply>
361             <field type="CARD8" name="xi_reply_type" />
362             <!-- only the following GrabStatus-values are valid here:
363                  "Success", "AlreadyGrabbed", and "Frozen"
364             -->
365             <field type="CARD8" name="status" enum="GrabStatus" />
366             <pad bytes="23" />
367         </reply>
368     </request>
369
370     <!-- ChangePointerDevice -->
371
372     <request name="ChangePointerDevice" opcode="12">
373         <field type="CARD8" name="x_axis" />
374         <field type="CARD8" name="y_axis" />
375         <field type="CARD8" name="device_id" />
376         <pad bytes="1" />
377         <reply>
378             <field type="CARD8" name="xi_reply_type" />
379             <!-- only the following GrabStatus-values are valid here:
380                  "Success", "AlreadyGrabbed", and "Frozen"
381             -->
382             <field type="CARD8" name="status" enum="GrabStatus" />
383             <pad bytes="23" />
384         </reply>
385     </request>
386
387     <!-- GrabDevice -->
388
389     <request name="GrabDevice" opcode="13">
390         <field type="WINDOW"    name="grab_window" />
391         <field type="TIMESTAMP" name="time" altenum="Time" />
392         <field type="CARD16"    name="num_classes" />
393         <field type="CARD8"     name="this_device_mode" enum="GrabMode" />
394         <field type="CARD8"     name="other_device_mode" enum="GrabMode" />
395         <field type="BOOL"      name="owner_events" />
396         <field type="CARD8"     name="device_id" />
397         <pad bytes="2" />
398         <list type="EventClass" name="classes">
399             <fieldref>num_classes</fieldref>
400         </list>
401         <reply>
402             <field type="CARD8" name="xi_reply_type" />
403             <field type="CARD8" name="status" enum="GrabStatus" />
404             <pad bytes="23" />
405         </reply>
406     </request>
407
408     <!-- UngrabDevice -->
409
410     <request name="UngrabDevice" opcode="14">
411         <field type="TIMESTAMP" name="time" altenum="Time" />
412         <field type="CARD8"     name="device_id" />
413         <pad bytes="3" />
414     </request>
415
416     <!-- GrabDeviceKey -->
417
418     <enum name="ModifierDevice">
419         <item name="UseXKeyboard"><value>255</value></item> <!-- 0xff -->
420     </enum>
421
422     <request name="GrabDeviceKey" opcode="15">
423         <field type="WINDOW" name="grab_window" />
424         <field type="CARD16" name="num_classes" />
425         <field type="CARD16" name="modifiers" mask="ModMask" />
426         <field type="CARD8"  name="modifier_device" altenum="ModifierDevice" />
427         <field type="CARD8"  name="grabbed_device" />
428         <field type="CARD8"  name="key" altenum="Grab" />
429         <field type="CARD8"  name="this_device_mode" enum="GrabMode" />
430         <field type="CARD8"  name="other_device_mode" enum="GrabMode" />
431         <field type="BOOL"   name="owner_events" />
432         <pad bytes="2" />
433         <list type="EventClass" name="classes">
434             <fieldref>num_classes</fieldref>
435         </list>
436     </request>
437
438     <!-- UngrabDeviceKey -->
439
440     <request name="UngrabDeviceKey" opcode="16">
441         <field type="WINDOW" name="grabWindow" />
442         <field type="CARD16" name="modifiers" mask="ModMask" />
443         <field type="CARD8"  name="modifier_device" altenum="ModifierDevice" />
444         <field type="CARD8"  name="key" altenum="Grab" />
445         <field type="CARD8"  name="grabbed_device" />
446     </request>
447
448     <!-- GrabDeviceButton -->
449
450     <request name="GrabDeviceButton" opcode="17">
451         <field type="WINDOW" name="grab_window" />
452         <field type="CARD8"  name="grabbed_device" />
453         <field type="CARD8"  name="modifier_device" altenum="ModifierDevice" />
454         <field type="CARD16" name="num_classes" />
455         <field type="CARD16" name="modifiers" mask="ModMask" />
456         <field type="CARD8"  name="this_device_mode" enum="GrabMode" />
457         <field type="CARD8"  name="other_device_mode" enum="GrabMode" />
458         <field type="CARD8"  name="button" altenum="Grab" />
459         <field type="BOOL"   name="owner_events" />
460         <pad bytes="2" />
461         <list type="EventClass" name="classes">
462             <fieldref>num_classes</fieldref>
463         </list>
464     </request>
465
466     <!-- UngrabDeviceButton -->
467
468     <request name="UngrabDeviceButton" opcode="18">
469         <field type="WINDOW" name="grab_window" />
470         <field type="CARD16" name="modifiers" mask="ModMask" />
471         <field type="CARD8"  name="modifier_device" altenum="ModifierDevice" />
472         <field type="CARD8"  name="button" altenum="Grab" />
473         <field type="CARD8"  name="grabbed_device" />
474         <pad bytes="3" />
475     </request>
476
477     <!-- AllowDeviceEvents -->
478
479     <enum name="DeviceInputMode">
480         <item name="AsyncThisDevice">   <value>0</value> </item>
481         <item name="SyncThisDevice">    <value>1</value> </item>
482         <item name="ReplayThisDevice">  <value>2</value> </item>
483         <item name="AsyncOtherDevices"> <value>3</value> </item>
484         <item name="AsyncAll">          <value>4</value> </item>
485         <item name="SyncAll">           <value>5</value> </item>
486     </enum>
487
488     <request name="AllowDeviceEvents" opcode="19">
489         <field type="TIMESTAMP" name="time" altenum="Time" />
490         <field type="CARD8"     name="mode" enum="DeviceInputMode" />
491         <field type="CARD8"     name="device_id" />
492         <pad bytes="2" />
493     </request>
494
495     <!-- GetDeviceFocus -->
496
497     <request name="GetDeviceFocus" opcode="20">
498         <field type="CARD8" name="device_id" />
499         <pad bytes="3" />
500         <reply>
501             <field type="CARD8"     name="xi_reply_type" />
502             <field type="WINDOW"    name="focus" altenum="InputFocus" />
503             <field type="TIMESTAMP" name="time" />
504             <field type="CARD8"     name="revert_to" enum="InputFocus" />
505             <pad bytes="15" />
506         </reply>
507     </request>
508
509     <!-- SetDeviceFocus -->
510
511     <request name="SetDeviceFocus" opcode="21">
512         <field type="WINDOW"    name="focus" altenum="InputFocus" />
513         <field type="TIMESTAMP" name="time" altenum="Time" />
514         <field type="CARD8"     name="revert_to" enum="InputFocus" />
515         <field type="CARD8"     name="device_id" />
516         <pad bytes="2" />
517     </request>
518
519     <!-- GetFeedbackControl -->
520
521     <enum name="FeedbackClass">
522         <item name="Keyboard"> <value>0</value> </item>
523         <item name="Pointer">  <value>1</value> </item>
524         <item name="String">   <value>2</value> </item>
525         <item name="Integer">  <value>3</value> </item>
526         <item name="Led">      <value>4</value> </item>
527         <item name="Bell">     <value>5</value> </item>
528     </enum>
529
530     <struct name="KbdFeedbackState">
531         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
532         <field type="CARD8"  name="feedback_id" />
533         <field type="CARD16" name="len" />
534         <field type="CARD16" name="pitch" />
535         <field type="CARD16" name="duration" />
536         <field type="CARD32" name="led_mask" />
537         <field type="CARD32" name="led_values" />
538         <field type="BOOL"   name="global_auto_repeat" />
539         <field type="CARD8"  name="click" />
540         <field type="CARD8"  name="percent" />
541         <pad bytes="1" />
542         <list type="CARD8" name="auto_repeats">
543             <value>32</value>
544         </list>
545     </struct>
546
547     <struct name="PtrFeedbackState">
548         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
549         <field type="CARD8"  name="feedback_id" />
550         <field type="CARD16" name="len" />
551         <pad bytes="2" />
552         <field type="CARD16" name="accel_num" />
553         <field type="CARD16" name="accel_denom" />
554         <field type="CARD16" name="threshold" />
555     </struct>
556
557     <struct name="IntegerFeedbackState">
558         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
559         <field type="CARD8"  name="feedback_id" />
560         <field type="CARD16" name="len" />
561         <field type="CARD32" name="resolution" />
562         <field type="INT32"  name="min_value" />
563         <field type="INT32"  name="max_value" />
564     </struct>
565
566     <struct name="StringFeedbackState">
567         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
568         <field type="CARD8"  name="feedback_id" />
569         <field type="CARD16" name="len" />
570         <field type="CARD16" name="max_symbols" />
571         <field type="CARD16" name="num_keysyms" />
572         <list type="KEYSYM"  name="keysyms">
573             <fieldref>num_keysyms</fieldref>
574         </list>
575     </struct>
576
577     <struct name="BellFeedbackState">
578         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
579         <field type="CARD8"  name="feedback_id" />
580         <field type="CARD16" name="len" />
581         <field type="CARD8"  name="percent" />
582         <pad bytes="3" />
583         <field type="CARD16" name="pitch" />
584         <field type="CARD16" name="duration" />
585     </struct>
586
587     <struct name="LedFeedbackState">
588         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
589         <field type="CARD8"  name="feedback_id" />
590         <field type="CARD16" name="len" />
591         <field type="CARD32" name="led_mask" />
592         <field type="CARD32" name="led_values" />
593     </struct>
594
595     <struct name="FeedbackState">
596         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
597         <field type="CARD8"  name="feedback_id" />
598         <field type="CARD16" name="len" />
599         <switch name="data">
600             <fieldref>class_id</fieldref>
601             <case name="keyboard">
602                 <enumref ref="FeedbackClass">Keyboard</enumref>
603                 <field type="CARD16" name="pitch" />
604                 <field type="CARD16" name="duration" />
605                 <field type="CARD32" name="led_mask" />
606                 <field type="CARD32" name="led_values" />
607                 <field type="BOOL"   name="global_auto_repeat" />
608                 <field type="CARD8"  name="click" />
609                 <field type="CARD8"  name="percent" />
610                 <pad bytes="1" />
611                 <list type="CARD8" name="auto_repeats">
612                     <value>32</value>
613                 </list>
614             </case>
615             <case name="pointer">
616                 <enumref ref="FeedbackClass">Pointer</enumref>
617                 <pad bytes="2" />
618                 <field type="CARD16" name="accel_num" />
619                 <field type="CARD16" name="accel_denom" />
620                 <field type="CARD16" name="threshold" />
621             </case>
622             <case name="string">
623                 <enumref ref="FeedbackClass">String</enumref>
624                 <field type="CARD16" name="max_symbols" />
625                 <field type="CARD16" name="num_keysyms" />
626                 <list type="KEYSYM"  name="keysyms">
627                     <fieldref>num_keysyms</fieldref>
628                 </list>
629             </case>
630             <case name="integer">
631                 <enumref ref="FeedbackClass">Integer</enumref>
632                 <field type="CARD32" name="resolution" />
633                 <field type="INT32"  name="min_value" />
634                 <field type="INT32"  name="max_value" />
635             </case>
636             <case name="led">
637                 <enumref ref="FeedbackClass">Led</enumref>
638                 <field type="CARD32" name="led_mask" />
639                 <field type="CARD32" name="led_values" />
640             </case>
641             <case name="bell">
642                 <enumref ref="FeedbackClass">Bell</enumref>
643                 <field type="CARD8"  name="percent" />
644                 <pad bytes="3" />
645                 <field type="CARD16" name="pitch" />
646                 <field type="CARD16" name="duration" />
647             </case>
648         </switch>
649     </struct>
650
651     <request name="GetFeedbackControl" opcode="22">
652         <field type="CARD8" name="device_id" />
653         <pad bytes="3" />
654         <reply>
655             <field type="CARD8"  name="xi_reply_type" />
656             <field type="CARD16" name="num_feedbacks" />
657             <pad bytes="22" />
658             <list type="FeedbackState" name="feedbacks">
659                 <fieldref>num_feedbacks</fieldref>
660             </list>
661         </reply>
662     </request>
663
664     <!-- ChangeFeedbackControl -->
665
666     <struct name="KbdFeedbackCtl">
667         <field type="CARD8"   name="class_id" enum="FeedbackClass" />
668         <field type="CARD8"   name="feedback_id" />
669         <field type="CARD16"  name="len" />
670         <field type="KeyCode" name="key" />
671         <field type="CARD8"   name="auto_repeat_mode" />
672         <field type="INT8"    name="key_click_percent" />
673         <field type="INT8"    name="bell_percent" />
674         <field type="INT16"   name="bell_pitch" />
675         <field type="INT16"   name="bell_duration" />
676         <field type="CARD32"  name="led_mask" />
677         <field type="CARD32"  name="led_values" />
678     </struct>
679
680     <struct name="PtrFeedbackCtl">
681         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
682         <field type="CARD8"  name="feedback_id" />
683         <field type="CARD16" name="len" />
684         <pad bytes="2" />
685         <field type="INT16"  name="num" />
686         <field type="INT16"  name="denom" />
687         <field type="INT16"  name="threshold" />
688     </struct>
689
690     <struct name="IntegerFeedbackCtl">
691         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
692         <field type="CARD8"  name="feedback_id" />
693         <field type="CARD16" name="len" />
694         <field type="INT32"  name="int_to_display" />
695     </struct>
696
697     <struct name="StringFeedbackCtl">
698         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
699         <field type="CARD8"  name="feedback_id" />
700         <field type="CARD16" name="len" />
701         <pad bytes="2" />
702         <field type="CARD16" name="num_keysyms" />
703         <list type="KEYSYM"  name="keysyms">
704             <fieldref>num_keysyms</fieldref>
705         </list>
706     </struct>
707
708     <struct name="BellFeedbackCtl">
709         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
710         <field type="CARD8"  name="feedback_id" />
711         <field type="CARD16" name="len" />
712         <field type="INT8"   name="percent" />
713         <pad bytes="3" />
714         <field type="INT16"  name="pitch" />
715         <field type="INT16"  name="duration" />
716     </struct>
717
718     <struct name="LedFeedbackCtl">
719         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
720         <field type="CARD8"  name="feedback_id" />
721         <field type="CARD16" name="len" />
722         <field type="CARD32" name="led_mask" />
723         <field type="CARD32" name="led_values" />
724     </struct>
725
726     <struct name="FeedbackCtl">
727         <field type="CARD8"  name="class_id" enum="FeedbackClass" />
728         <field type="CARD8"  name="feedback_id" />
729         <field type="CARD16" name="len" />
730         <switch name="data">
731             <fieldref>class_id</fieldref>
732             <case name="keyboard">
733                 <enumref ref="FeedbackClass">Keyboard</enumref>
734                 <field type="KeyCode" name="key" />
735                 <field type="CARD8"   name="auto_repeat_mode" />
736                 <field type="INT8"    name="key_click_percent" />
737                 <field type="INT8"    name="bell_percent" />
738                 <field type="INT16"   name="bell_pitch" />
739                 <field type="INT16"   name="bell_duration" />
740                 <field type="CARD32"  name="led_mask" />
741                 <field type="CARD32"  name="led_values" />
742             </case>
743             <case name="pointer">
744                 <enumref ref="FeedbackClass">Pointer</enumref>
745                 <pad bytes="2" />
746                 <field type="INT16"  name="num" />
747                 <field type="INT16"  name="denom" />
748                 <field type="INT16"  name="threshold" />
749             </case>
750             <case name="string">
751                 <enumref ref="FeedbackClass">String</enumref>
752                 <pad bytes="2" />
753                 <field type="CARD16" name="num_keysyms" />
754                 <list type="KEYSYM"  name="keysyms">
755                     <fieldref>num_keysyms</fieldref>
756                 </list>
757             </case>
758             <case name="integer">
759                 <enumref ref="FeedbackClass">Integer</enumref>
760                 <field type="INT32"  name="int_to_display" />
761             </case>
762             <case name="led">
763                 <enumref ref="FeedbackClass">Led</enumref>
764                 <field type="CARD32" name="led_mask" />
765                 <field type="CARD32" name="led_values" />
766             </case>
767             <case name="bell">
768                 <enumref ref="FeedbackClass">Bell</enumref>
769                 <field type="INT8"   name="percent" />
770                 <pad bytes="3" />
771                 <field type="INT16"  name="pitch" />
772                 <field type="INT16"  name="duration" />
773             </case>
774         </switch>
775     </struct>
776
777     <enum name="ChangeFeedbackControlMask">
778         <item name="KeyClickPercent">  <bit>0</bit> </item> <!-- 0x01 -->
779         <item name="Percent">          <bit>1</bit> </item> <!-- 0x02 -->
780         <item name="Pitch">            <bit>2</bit> </item> <!-- 0x04 -->
781         <item name="Duration">         <bit>3</bit> </item> <!-- 0x08 -->
782         <item name="Led">              <bit>4</bit> </item> <!-- 0x10 -->
783         <item name="LedMode">          <bit>5</bit> </item> <!-- 0x20 -->
784         <item name="Key">              <bit>6</bit> </item> <!-- 0x40 -->
785         <item name="AutoRepeatMode">   <bit>7</bit> </item> <!-- 0x80 -->
786         <item name="String">           <bit>0</bit> </item> <!-- 0x01 -->
787         <item name="Integer">          <bit>0</bit> </item> <!-- 0x01 -->
788         <item name="AccelNum">         <bit>0</bit> </item> <!-- 0x01 -->
789         <item name="AccelDenom">       <bit>1</bit> </item> <!-- 0x02 -->
790         <item name="Threshold">        <bit>2</bit> </item> <!-- 0x04 -->
791     </enum>
792
793     <request name="ChangeFeedbackControl" opcode="23">
794         <field type="CARD32"      name="mask" mask="ChangeFeedbackControlMask" />
795         <field type="CARD8"       name="device_id" />
796         <field type="CARD8"       name="feedback_id" />
797         <pad bytes="2" />
798         <field type="FeedbackCtl" name="feedback" />
799     </request>
800
801     <!-- GetDeviceKeyMapping -->
802
803     <request name="GetDeviceKeyMapping" opcode="24">
804         <field type="CARD8"   name="device_id" />
805         <field type="KeyCode" name="first_keycode" />
806         <field type="CARD8"   name="count" />
807         <pad bytes="1" />
808         <reply>
809             <field type="CARD8" name="xi_reply_type" />
810             <field type="CARD8" name="keysyms_per_keycode" />
811             <pad bytes="23" />
812             <list type="KEYSYM" name="keysyms">
813                 <!-- 'length' is a field in the header -->
814                 <fieldref>length</fieldref>
815             </list>
816         </reply>
817     </request>
818
819     <!-- ChangeDeviceKeyMapping -->
820
821     <request name="ChangeDeviceKeyMapping" opcode="25">
822         <field type="CARD8"   name="device_id" />
823         <field type="KeyCode" name="first_keycode" />
824         <field type="CARD8"   name="keysyms_per_keycode" />
825         <field type="CARD8"   name="keycode_count" />
826         <list type="KEYSYM"   name="keysyms">
827             <op op="*">
828                 <fieldref>keycode_count</fieldref>
829                 <fieldref>keysyms_per_keycode</fieldref>
830             </op>
831         </list>
832     </request>
833
834     <!-- GetDeviceModifierMapping -->
835
836     <request name="GetDeviceModifierMapping" opcode="26">
837         <field type="CARD8" name="device_id" />
838         <pad bytes="3" />
839         <reply>
840             <field type="CARD8" name="xi_reply_type" />
841             <field type="CARD8" name="keycodes_per_modifier" />
842             <pad bytes="23" />
843             <list type="CARD8"  name="keymaps">
844                 <op op="*">
845                     <fieldref>keycodes_per_modifier</fieldref>
846                     <value>8</value>
847                 </op>
848             </list>
849         </reply>
850     </request>
851
852     <!-- SetDeviceModifierMapping -->
853
854     <request name="SetDeviceModifierMapping" opcode="27">
855         <field type="CARD8" name="device_id" />
856         <field type="CARD8" name="keycodes_per_modifier" />
857         <pad bytes="2" />
858         <list type="CARD8" name="keymaps">
859             <op op="*">
860                 <fieldref>keycodes_per_modifier</fieldref>
861                 <value>8</value>
862             </op>
863         </list>
864         <reply>
865             <field type="CARD8" name="xi_reply_type" />
866             <field type="CARD8" name="status" enum="MappingStatus" />
867             <pad bytes="23" />
868         </reply>
869     </request>
870
871     <!-- GetDeviceButtonMapping -->
872
873     <request name="GetDeviceButtonMapping" opcode="28">
874         <field type="CARD8" name="device_id" />
875         <pad bytes="3" />
876         <reply>
877             <field type="CARD8" name="xi_reply_type" />
878             <field type="CARD8" name="map_size" />
879             <pad bytes="23" />
880             <list type="CARD8" name="map">
881                 <fieldref>map_size</fieldref>
882             </list>
883             <pad align="4" />
884         </reply>
885     </request>
886
887     <!-- SetDeviceButtonMapping -->
888
889     <request name="SetDeviceButtonMapping" opcode="29">
890         <field type="CARD8" name="device_id" />
891         <field type="CARD8" name="map_size" />
892         <pad bytes="2" />
893         <list type="CARD8" name="map">
894             <fieldref>map_size</fieldref>
895         </list>
896         <reply>
897             <field type="CARD8" name="xi_reply_type" />
898             <field type="CARD8" name="status" enum="MappingStatus" />
899             <pad bytes="23" />
900         </reply>
901     </request>
902
903     <!-- QueryDeviceState -->
904
905     <struct name="KeyState">
906         <field type="CARD8" name="class_id" enum="InputClass" />
907         <field type="CARD8" name="len" />
908         <field type="CARD8" name="num_keys" />
909         <pad bytes="1" />
910         <list type="CARD8" name="keys">
911             <value>32</value>
912         </list>
913     </struct>
914
915     <struct name="ButtonState">
916         <field type="CARD8" name="class_id" enum="InputClass" />
917         <field type="CARD8" name="len" />
918         <field type="CARD8" name="num_buttons" />
919         <pad bytes="1" />
920         <list type="CARD8" name="buttons">
921             <value>32</value>
922         </list>
923     </struct>
924
925     <enum name="ValuatorStateModeMask">
926         <item name="DeviceModeAbsolute"> <bit>0</bit> </item>
927         <item name="OutOfProximity">     <bit>1</bit> </item>
928     </enum>
929
930     <struct name="ValuatorState">
931         <field type="CARD8" name="class_id" enum="InputClass" />
932         <field type="CARD8" name="len" />
933         <field type="CARD8" name="num_valuators" />
934         <field type="CARD8" name="mode" mask="ValuatorStateModeMask" />
935         <list type="INT32" name="valuators">
936             <fieldref>num_valuators</fieldref>
937         </list>
938     </struct>
939
940     <struct name="InputState">
941         <field type="CARD8" name="class_id" enum="InputClass" />
942         <field type="CARD8" name="len" />
943         <switch name="data">
944             <fieldref>class_id</fieldref>
945             <case name="key">
946                 <enumref ref="InputClass">Key</enumref>
947                 <field type="CARD8" name="num_keys" />
948                 <pad bytes="1" />
949                 <list type="CARD8" name="keys">
950                     <value>32</value>
951                 </list>
952             </case>
953             <case name="button">
954                 <enumref ref="InputClass">Button</enumref>
955                 <field type="CARD8" name="num_buttons" />
956                 <pad bytes="1" />
957                 <list type="CARD8" name="buttons">
958                     <value>32</value>
959                 </list>
960             </case>
961             <case name="valuator">
962                 <enumref ref="InputClass">Valuator</enumref>
963                 <field type="CARD8" name="num_valuators" />
964                 <field type="CARD8" name="mode" mask="ValuatorStateModeMask" />
965                 <list type="INT32" name="valuators">
966                     <fieldref>num_valuators</fieldref>
967                 </list>
968             </case>
969         </switch>
970     </struct>
971
972     <request name="QueryDeviceState" opcode="30">
973         <field type="CARD8" name="device_id" />
974         <pad bytes="3" />
975         <reply>
976             <field type="CARD8" name="xi_reply_type" />
977             <field type="CARD8" name="num_classes" />
978             <pad bytes="23" />
979             <list type="InputState" name="classes">
980                 <fieldref>num_classes</fieldref>
981             </list>
982         </reply>
983     </request>
984
985     <!-- SendExtensionEvent -->
986
987     <request name="SendExtensionEvent" opcode="31">
988         <field type="WINDOW" name="destination" />
989         <field type="CARD8"  name="device_id" />
990         <field type="BOOL"   name="propagate" />
991         <field type="CARD16" name="num_classes" />
992         <field type="CARD8"  name="num_events" />
993         <pad bytes="3" />
994         <list type="CARD8" name="events">
995             <op op="*">
996                 <fieldref>num_events</fieldref>
997                 <value>32</value>
998             </op>
999         </list>
1000         <list type="EventClass" name="classes">
1001             <fieldref>num_classes</fieldref>
1002         </list>
1003     </request>
1004
1005     <!-- DeviceBell -->
1006
1007     <request name="DeviceBell" opcode="32">
1008         <field type="CARD8" name="device_id" />
1009         <field type="CARD8" name="feedback_id" />
1010         <field type="CARD8" name="feedback_class" />
1011         <field type="INT8"  name="percent" />
1012     </request>
1013
1014     <!-- SetDeviceValuators -->
1015
1016     <request name="SetDeviceValuators" opcode="33">
1017         <field type="CARD8" name="device_id" />
1018         <field type="CARD8" name="first_valuator" />
1019         <field type="CARD8" name="num_valuators" />
1020         <pad bytes="1" />
1021         <list type="INT32" name="valuators">
1022             <fieldref>num_valuators</fieldref>
1023         </list>
1024         <reply>
1025             <field type="CARD8" name="xi_reply_type" />
1026             <field type="CARD8" name="status" enum="GrabStatus" />
1027             <pad bytes="23" />
1028         </reply>
1029     </request>
1030
1031     <!-- GetDeviceControl -->
1032
1033     <enum name="DeviceControl">
1034         <item name="resolution"> <value>1</value> </item>
1035         <item name="abs_calib">  <value>2</value> </item>
1036         <item name="core">       <value>3</value> </item>
1037         <item name="enable">     <value>4</value> </item>
1038         <item name="abs_area">   <value>5</value> </item>
1039     </enum>
1040
1041     <struct name="DeviceResolutionState">
1042         <field type="CARD16" name="control_id" enum="DeviceControl" />
1043         <field type="CARD16" name="len" />
1044         <field type="CARD32" name="num_valuators" />
1045         <list type="CARD32"  name="resolution_values">
1046             <fieldref>num_valuators</fieldref>
1047         </list>
1048         <list type="CARD32" name="resolution_min">
1049             <fieldref>num_valuators</fieldref>
1050         </list>
1051         <list type="CARD32" name="resolution_max">
1052             <fieldref>num_valuators</fieldref>
1053         </list>
1054     </struct>
1055
1056     <struct name="DeviceAbsCalibState">
1057         <field type="CARD16" name="control_id" enum="DeviceControl" />
1058         <field type="CARD16" name="len" />
1059         <field type="INT32"  name="min_x" />
1060         <field type="INT32"  name="max_x" />
1061         <field type="INT32"  name="min_y" />
1062         <field type="INT32"  name="max_y" />
1063         <field type="CARD32" name="flip_x" />
1064         <field type="CARD32" name="flip_y" />
1065         <field type="CARD32" name="rotation" />
1066         <field type="CARD32" name="button_threshold" />
1067     </struct>
1068
1069     <struct name="DeviceAbsAreaState">
1070         <field type="CARD16" name="control_id" enum="DeviceControl" />
1071         <field type="CARD16" name="len" />
1072         <field type="CARD32" name="offset_x" />
1073         <field type="CARD32" name="offset_y" />
1074         <field type="CARD32" name="width" />
1075         <field type="CARD32" name="height" />
1076         <field type="CARD32" name="screen" />
1077         <field type="CARD32" name="following" />
1078     </struct>
1079
1080     <struct name="DeviceCoreState">
1081         <field type="CARD16" name="control_id" enum="DeviceControl" />
1082         <field type="CARD16" name="len" />
1083         <field type="CARD8"  name="status" />
1084         <field type="CARD8"  name="iscore" />
1085         <pad bytes="2" />
1086     </struct>
1087
1088     <struct name="DeviceEnableState">
1089         <field type="CARD16" name="control_id" enum="DeviceControl" />
1090         <field type="CARD16" name="len" />
1091         <field type="CARD8"  name="enable" />
1092         <pad bytes="3" />
1093     </struct>
1094
1095     <struct name="DeviceState">
1096         <field type="CARD16" name="control_id" enum="DeviceControl" />
1097         <field type="CARD16" name="len" />
1098         <list type="CARD8" name="uninterpreted_data">
1099             <op op="-">
1100                 <fieldref>len</fieldref>
1101                 <value>4</value>
1102             </op>
1103         </list>
1104     </struct>
1105
1106     <request name="GetDeviceControl" opcode="34">
1107         <field type="CARD16" name="control_id" enum="DeviceControl" />
1108         <field type="CARD8"  name="device_id" />
1109         <pad bytes="1" />
1110         <reply>
1111             <field type="CARD8" name="xi_reply_type" />
1112             <field type="CARD8" name="status" altenum="GrabStatus" />
1113             <pad bytes="23" />
1114             <field type="DeviceState" name="control" />
1115         </reply>
1116     </request>
1117
1118     <!-- ChangeDeviceControl -->
1119
1120     <struct name="DeviceResolutionCtl">
1121         <field type="CARD16" name="control_id" enum="DeviceControl" />
1122         <field type="CARD16" name="len" />
1123         <field type="CARD8"  name="first_valuator" />
1124         <field type="CARD8"  name="num_valuators" />
1125         <pad bytes="2" />
1126         <list type="CARD32"  name="resolution_values">
1127             <fieldref>num_valuators</fieldref>
1128         </list>
1129     </struct>
1130
1131     <struct name="DeviceAbsCalibCtl">
1132         <field type="CARD16" name="control_id" enum="DeviceControl" />
1133         <field type="CARD16" name="len" />
1134         <field type="INT32"  name="min_x" />
1135         <field type="INT32"  name="max_x" />
1136         <field type="INT32"  name="min_y" />
1137         <field type="INT32"  name="max_y" />
1138         <field type="CARD32" name="flip_x" />
1139         <field type="CARD32" name="flip_y" />
1140         <field type="CARD32" name="rotation" />
1141         <field type="CARD32" name="button_threshold" />
1142     </struct>
1143
1144     <struct name="DeviceAbsAreaCtrl">
1145         <field type="CARD16" name="control_id" enum="DeviceControl" />
1146         <field type="CARD16" name="len" />
1147         <field type="CARD32" name="offset_x" />
1148         <field type="CARD32" name="offset_y" />
1149         <field type="INT32"  name="width" />
1150         <field type="INT32"  name="height" />
1151         <field type="INT32"  name="screen" />
1152         <field type="CARD32" name="following" />
1153     </struct>
1154
1155     <struct name="DeviceCoreCtrl">
1156         <field type="CARD16" name="control_id" enum="DeviceControl" />
1157         <field type="CARD16" name="len" />
1158         <field type="CARD8"  name="status" />
1159         <pad bytes="3" />
1160     </struct>
1161
1162     <struct name="DeviceEnableCtrl">
1163         <field type="CARD16" name="control_id" enum="DeviceControl" />
1164         <field type="CARD16" name="len" />
1165         <field type="CARD8"  name="enable" />
1166         <pad bytes="3" />
1167     </struct>
1168
1169     <struct name="DeviceCtl">
1170         <field type="CARD16" name="control_id" enum="DeviceControl" />
1171         <field type="CARD16" name="len" />
1172         <list type="CARD8" name="uninterpreted_data">
1173             <op op="-">
1174                 <fieldref>len</fieldref>
1175                 <value>4</value>
1176             </op>
1177         </list>
1178     </struct>
1179
1180     <request name="ChangeDeviceControl" opcode="35">
1181         <field type="CARD16" name="control_id" enum="DeviceControl" />
1182         <field type="CARD8"  name="device_id" />
1183         <pad bytes="1" />
1184         <field type="DeviceCtl" name="control" />
1185         <reply>
1186             <field type="CARD8" name="xi_reply_type" />
1187             <field type="CARD8" name="status" altenum="GrabStatus" />
1188             <pad bytes="23" />
1189         </reply>
1190     </request>
1191
1192     <!-- ⋅⋅⋅ Requests (v1.5) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1193
1194     <!-- ListDeviceProperties -->
1195
1196     <request name="ListDeviceProperties" opcode="36">
1197         <field type="CARD8"  name="device_id" />
1198         <pad bytes="3" />
1199         <reply>
1200             <field type="CARD8"  name="xi_reply_type" />
1201             <field type="CARD16" name="num_atoms" />
1202             <pad bytes="22" />
1203             <list type="ATOM" name="atoms">
1204                 <fieldref>num_atoms</fieldref>
1205             </list>
1206         </reply>
1207     </request>
1208
1209     <!-- ChangeDeviceProperty -->
1210
1211     <enum name="PropertyFormat">
1212         <item name="8Bits">  <value>8</value> </item>
1213         <item name="16Bits"> <value>16</value> </item>
1214         <item name="32Bits"> <value>32</value> </item>
1215     </enum>
1216
1217     <request name="ChangeDeviceProperty" opcode="37">
1218         <field type="ATOM"  name="property" />
1219         <field type="ATOM"  name="type" />
1220         <field type="CARD8" name="device_id" />
1221         <field type="CARD8" name="format" enum="PropertyFormat" />
1222         <field type="CARD8" name="mode" enum="PropMode" />
1223         <pad bytes="1" />
1224         <field type="CARD32" name="num_items" />
1225         <switch name="items">
1226             <fieldref>format</fieldref>
1227             <case>
1228                 <enumref ref="PropertyFormat">8Bits</enumref>
1229                 <list type="CARD8" name="data8">
1230                     <fieldref>num_items</fieldref>
1231                 </list>
1232                 <pad align="4" />
1233             </case>
1234             <case>
1235                 <enumref ref="PropertyFormat">16Bits</enumref>
1236                 <list type="CARD16" name="data16">
1237                     <fieldref>num_items</fieldref>
1238                 </list>
1239                 <pad align="4" />
1240             </case>
1241             <case>
1242                 <enumref ref="PropertyFormat">32Bits</enumref>
1243                 <list type="CARD32" name="data32">
1244                     <fieldref>num_items</fieldref>
1245                 </list>
1246             </case>
1247         </switch>
1248     </request>
1249
1250     <!-- DeleteDeviceProperty -->
1251
1252     <request name="DeleteDeviceProperty" opcode="38">
1253         <field type="ATOM"  name="property" />
1254         <field type="CARD8" name="device_id" />
1255         <pad bytes="3" />
1256     </request>
1257
1258     <!-- GetDeviceProperty -->
1259
1260     <request name="GetDeviceProperty" opcode="39">
1261         <field type="ATOM"   name="property" />
1262         <field type="ATOM"   name="type" />
1263         <field type="CARD32" name="offset" />
1264         <field type="CARD32" name="len" />
1265         <field type="CARD8"  name="device_id" />
1266         <field type="BOOL"   name="delete" />
1267         <pad bytes="2" />
1268         <reply>
1269             <field type="CARD8"  name="xi_reply_type" />
1270             <field type="ATOM"   name="type" />
1271             <field type="CARD32" name="bytes_after" />
1272             <field type="CARD32" name="num_items" />
1273             <field type="CARD8"  name="format" enum="PropertyFormat" />
1274             <field type="CARD8"  name="device_id" />
1275             <pad bytes="10" />
1276             <switch name="items">
1277                 <fieldref>format</fieldref>
1278                 <!-- <bitcase> is not correct, this would need <cases>s.
1279                      It works in that case, because PropertyFormat items can be
1280                      distinguished exactly as their values don't have equal bits.
1281                 -->
1282                 <bitcase>
1283                     <enumref ref="PropertyFormat">8Bits</enumref>
1284                     <list type="CARD8" name="data8">
1285                         <fieldref>num_items</fieldref>
1286                     </list>
1287                     <pad align="4" />
1288                 </bitcase>
1289                 <bitcase>
1290                     <enumref ref="PropertyFormat">16Bits</enumref>
1291                     <list type="CARD16" name="data16">
1292                         <fieldref>num_items</fieldref>
1293                     </list>
1294                     <pad align="4" />
1295                 </bitcase>
1296                 <bitcase>
1297                     <enumref ref="PropertyFormat">32Bits</enumref>
1298                     <list type="CARD32" name="data32">
1299                         <fieldref>num_items</fieldref>
1300                     </list>
1301                 </bitcase>
1302             </switch>
1303         </reply>
1304     </request>
1305
1306     <!-- ⋅⋅⋅ Requests (v2.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1307
1308     <!-- XIQueryPointer -->
1309
1310     <enum name="Device">
1311         <item name="All">       <value>0</value> </item>
1312         <item name="AllMaster"> <value>1</value> </item>
1313     </enum>
1314
1315     <struct name="GroupInfo">
1316         <field type="CARD8" name="base" />
1317         <field type="CARD8" name="latched" />
1318         <field type="CARD8" name="locked" />
1319         <field type="CARD8" name="effective" />
1320     </struct>
1321
1322     <struct name="ModifierInfo">
1323         <field type="CARD32" name="base" />
1324         <field type="CARD32" name="latched" />
1325         <field type="CARD32" name="locked" />
1326         <field type="CARD32" name="effective" />
1327     </struct>
1328
1329     <request name="XIQueryPointer" opcode="40">
1330         <field type="WINDOW"   name="window" />
1331         <field type="DeviceId" name="deviceid" altenum="Device" />
1332         <pad bytes="2" />
1333         <reply>
1334             <pad bytes="1" />
1335             <field type="WINDOW"       name="root" />
1336             <field type="WINDOW"       name="child" />
1337             <field type="FP1616"       name="root_x" />
1338             <field type="FP1616"       name="root_y" />
1339             <field type="FP1616"       name="win_x" />
1340             <field type="FP1616"       name="win_y" />
1341             <field type="BOOL"         name="same_screen" />
1342             <pad bytes="1" />
1343             <field type="CARD16"       name="buttons_len" />
1344             <field type="ModifierInfo" name="mods" />
1345             <field type="GroupInfo"    name="group" />
1346             <list type="CARD32" name="buttons">
1347                 <fieldref>buttons_len</fieldref>
1348             </list>
1349         </reply>
1350     </request>
1351
1352     <!-- XIWarpPointer -->
1353
1354     <request name="XIWarpPointer" opcode="41">
1355         <field type="WINDOW"   name="src_win" />
1356         <field type="WINDOW"   name="dst_win" />
1357         <field type="FP1616"   name="src_x" />
1358         <field type="FP1616"   name="src_y" />
1359         <field type="CARD16"   name="src_width" />
1360         <field type="CARD16"   name="src_height" />
1361         <field type="FP1616"   name="dst_x" />
1362         <field type="FP1616"   name="dst_y" />
1363         <field type="DeviceId" name="deviceid" altenum="Device" />
1364         <pad bytes="2" />
1365     </request>
1366
1367     <!-- XIChangeCursor -->
1368
1369     <request name="XIChangeCursor" opcode="42">
1370         <field type="WINDOW"   name="window" />
1371         <field type="CURSOR"   name="cursor" />
1372         <field type="DeviceId" name="deviceid" altenum="Device" />
1373         <pad bytes="2" />
1374     </request>
1375
1376     <!-- XIChangeHierarchy -->
1377
1378     <enum name="HierarchyChangeType">
1379         <item name="AddMaster">    <value>1</value> </item>
1380         <item name="RemoveMaster"> <value>2</value> </item>
1381         <item name="AttachSlave">  <value>3</value> </item>
1382         <item name="DetachSlave">  <value>4</value> </item>
1383     </enum>
1384
1385     <enum name="ChangeMode">
1386         <item name="Attach"> <value>1</value> </item>
1387         <item name="Float">  <value>2</value> </item>
1388     </enum>
1389
1390     <struct name="AddMaster">
1391         <field type="CARD16" name="type" enum="HierarchyChangeType" />
1392         <field type="CARD16" name="len" />
1393         <field type="CARD16" name="name_len" />
1394         <field type="BOOL"   name="send_core" />
1395         <field type="BOOL"   name="enable" />
1396         <list type="char" name="name">
1397             <fieldref>name_len</fieldref>
1398         </list>
1399         <pad align="4" />
1400     </struct>
1401
1402     <struct name="RemoveMaster">
1403         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1404         <field type="CARD16"   name="len" />
1405         <field type="DeviceId" name="deviceid" altenum="Device" />
1406         <field type="CARD8"    name="return_mode" enum="ChangeMode" />
1407         <pad bytes="1" />
1408         <field type="DeviceId" name="return_pointer" altenum="Device" />
1409         <field type="DeviceId" name="return_keyboard" altenum="Device" />
1410     </struct>
1411
1412     <struct name="AttachSlave">
1413         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1414         <field type="CARD16"   name="len" />
1415         <field type="DeviceId" name="deviceid" altenum="Device" />
1416         <field type="DeviceId" name="master" altenum="Device" />
1417     </struct>
1418
1419     <struct name="DetachSlave">
1420         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1421         <field type="CARD16"   name="len" />
1422         <field type="DeviceId" name="deviceid" altenum="Device" />
1423         <pad bytes="2" />
1424     </struct>
1425
1426     <struct name="HierarchyChange">
1427         <field type="CARD16" name="type" enum="HierarchyChangeType" />
1428         <field type="CARD16" name="len" />
1429         <list type="CARD8" name="uninterpreted_data">
1430             <op op="-">
1431                 <op op="*">
1432                     <fieldref>len</fieldref>
1433                     <value>4</value>
1434                 </op>
1435                 <value>4</value>
1436             </op>
1437         </list>
1438     </struct>
1439
1440     <request name="XIChangeHierarchy" opcode="43">
1441         <field type="CARD8" name="num_changes" />
1442         <pad bytes="3" />
1443         <list type="HierarchyChange" name="changes">
1444             <fieldref>num_changes</fieldref>
1445         </list>
1446     </request>
1447
1448     <!-- XISetClientPointer -->
1449
1450     <request name="XISetClientPointer" opcode="44">
1451         <field type="WINDOW"   name="window" />
1452         <field type="DeviceId" name="deviceid" altenum="Device" />
1453         <pad bytes="2" />
1454     </request>
1455
1456     <!-- XIGetClientPointer -->
1457
1458     <request name="XIGetClientPointer" opcode="45">
1459         <field type="WINDOW" name="window" />
1460         <reply>
1461             <pad bytes="1" />
1462             <field type="BOOL"     name="set" />
1463             <pad bytes="1" />
1464             <field type="DeviceId" name="deviceid" altenum="Device" />
1465             <pad bytes="20" />
1466         </reply>
1467     </request>
1468
1469     <!-- XISelectEvents -->
1470
1471     <enum name="XIEventMask">
1472         <item name="DeviceChanged">    <bit>1</bit> </item>
1473         <item name="KeyPress">         <bit>2</bit> </item>
1474         <item name="KeyRelease">       <bit>3</bit> </item>
1475         <item name="ButtonPress">      <bit>4</bit> </item>
1476         <item name="ButtonRelease">    <bit>5</bit> </item>
1477         <item name="Motion">           <bit>6</bit> </item>
1478         <item name="Enter">            <bit>7</bit> </item>
1479         <item name="Leave">            <bit>8</bit> </item>
1480         <item name="FocusIn">          <bit>9</bit> </item>
1481         <item name="FocusOut">         <bit>10</bit> </item>
1482         <item name="Hierarchy">        <bit>11</bit> </item>
1483         <item name="Property">         <bit>12</bit> </item>
1484         <!-- ⋅⋅⋅ Events (v2.1) ⋅⋅⋅ -->
1485         <item name="RawKeyPress">      <bit>13</bit> </item>
1486         <item name="RawKeyRelease">    <bit>14</bit> </item>
1487         <item name="RawButtonPress">   <bit>15</bit> </item>
1488         <item name="RawButtonRelease"> <bit>16</bit> </item>
1489         <item name="RawMotion">        <bit>17</bit> </item>
1490         <!-- ⋅⋅⋅ Events (v2.2) ⋅⋅⋅ -->
1491         <item name="TouchBegin">       <bit>18</bit> </item>
1492         <item name="TouchUpdate">      <bit>19</bit> </item>
1493         <item name="TouchEnd">         <bit>20</bit> </item>
1494         <item name="TouchOwnership">   <bit>21</bit> </item>
1495         <item name="RawTouchBegin">    <bit>22</bit> </item>
1496         <item name="RawTouchUpdate">   <bit>23</bit> </item>
1497         <item name="RawTouchEnd">      <bit>24</bit> </item>
1498         <!-- ⋅⋅⋅ Events (v2.3) ⋅⋅⋅ -->
1499         <item name="BarrierHit">       <bit>25</bit> </item>
1500         <item name="BarrierLeave">     <bit>26</bit> </item>
1501     </enum>
1502
1503     <struct name="EventMask">
1504         <field type="DeviceId" name="deviceid" altenum="Device" />
1505         <field type="CARD16"   name="mask_len" />
1506         <list type="CARD32" name="mask" mask="XIEventMask">
1507             <fieldref>mask_len</fieldref>
1508         </list>
1509     </struct>
1510
1511     <request name="XISelectEvents" opcode="46">
1512         <field type="WINDOW" name="window" />
1513         <field type="CARD16" name="num_mask" />
1514         <pad bytes="2" />
1515         <list type="EventMask" name="masks">
1516             <fieldref>num_mask</fieldref>
1517         </list>
1518     </request>
1519
1520     <!-- XIQueryVersion -->
1521
1522     <request name="XIQueryVersion" opcode="47">
1523         <field type="CARD16" name="major_version" />
1524         <field type="CARD16" name="minor_version" />
1525
1526         <reply>
1527             <pad bytes="1" />
1528             <field type="CARD16" name="major_version" />
1529             <field type="CARD16" name="minor_version" />
1530             <pad bytes="20" />
1531         </reply>
1532     </request>
1533
1534     <!-- XIQueryDevice -->
1535
1536     <enum name="DeviceClassType">
1537         <item name="Key">      <value>0</value> </item>
1538         <item name="Button">   <value>1</value> </item>
1539         <item name="Valuator"> <value>2</value> </item>
1540         <item name="Scroll">   <value>3</value> </item>
1541         <item name="Touch">    <value>8</value> </item>
1542     </enum>
1543
1544     <enum name="DeviceType">
1545         <item name="MasterPointer">  <value>1</value> </item>
1546         <item name="MasterKeyboard"> <value>2</value> </item>
1547         <item name="SlavePointer">   <value>3</value> </item>
1548         <item name="SlaveKeyboard">  <value>4</value> </item>
1549         <item name="FloatingSlave">  <value>5</value> </item>
1550     </enum>
1551
1552     <enum name="ScrollFlags">
1553         <item name="NoEmulation"> <bit>0</bit> </item>
1554         <item name="Preferred">   <bit>1</bit> </item>
1555     </enum>
1556
1557     <enum name="ScrollType">
1558         <item name="Vertical">   <value>1</value> </item>
1559         <item name="Horizontal"> <value>2</value> </item>
1560     </enum>
1561
1562     <enum name="TouchMode">
1563         <item name="Direct">    <value>1</value> </item>
1564         <item name="Dependent"> <value>2</value> </item>
1565     </enum>
1566
1567     <struct name="ButtonClass">
1568         <field type="CARD16"   name="type" enum="DeviceClassType" />
1569         <field type="CARD16"   name="len" />
1570         <field type="DeviceId" name="sourceid" />
1571         <field type="CARD16"   name="num_buttons" />
1572         <list type="CARD32"    name="state">
1573             <op op="/">
1574                 <op op="+">
1575                     <fieldref>num_buttons</fieldref>
1576                     <value>31</value>
1577                 </op>
1578                 <value>32</value>
1579             </op>
1580         </list>
1581         <list type="ATOM" name="labels">
1582             <fieldref>num_buttons</fieldref>
1583         </list>
1584     </struct>
1585
1586     <struct name="KeyClass">
1587         <field type="CARD16"   name="type" enum="DeviceClassType" />
1588         <field type="CARD16"   name="len" />
1589         <field type="DeviceId" name="sourceid" />
1590         <field type="CARD16"   name="num_keys" />
1591         <list type="CARD32" name="keys">
1592             <fieldref>num_keys</fieldref>
1593         </list>
1594     </struct>
1595
1596     <struct name="ScrollClass">
1597         <field type="CARD16"   name="type" enum="DeviceClassType" />
1598         <field type="CARD16"   name="len" />
1599         <field type="DeviceId" name="sourceid" />
1600         <field type="CARD16"   name="number" />
1601         <field type="CARD16"   name="scroll_type" enum="ScrollType" />
1602         <pad bytes="2" />
1603         <field type="CARD32"   name="flags" mask="ScrollFlags" />
1604         <field type="FP3232"   name="increment" />
1605     </struct>
1606
1607     <struct name="TouchClass">
1608         <field type="CARD16"   name="type" enum="DeviceClassType" />
1609         <field type="CARD16"   name="len" />
1610         <field type="DeviceId" name="sourceid" />
1611         <field type="CARD8"    name="mode" enum="TouchMode" />
1612         <field type="CARD8"    name="num_touches" />
1613     </struct>
1614
1615     <struct name="ValuatorClass">
1616         <field type="CARD16"   name="type" enum="DeviceClassType" />
1617         <field type="CARD16"   name="len" />
1618         <field type="DeviceId" name="sourceid" />
1619         <field type="CARD16"   name="number" />
1620         <field type="ATOM"     name="label" />
1621         <field type="FP3232"   name="min" />
1622         <field type="FP3232"   name="max" />
1623         <field type="FP3232"   name="value" />
1624         <field type="CARD32"   name="resolution" />
1625         <field type="CARD8"    name="mode" enum="ValuatorMode" />
1626         <pad bytes="3" />
1627     </struct>
1628
1629     <struct name="DeviceClass">
1630         <field type="CARD16"   name="type" enum="DeviceClassType" />
1631         <field type="CARD16"   name="len" />
1632         <field type="DeviceId" name="sourceid" />
1633         <pad bytes="2" />
1634         <list type="CARD8" name="uninterpreted_data">
1635             <op op="-">
1636                 <op op="*">
1637                     <fieldref>len</fieldref>
1638                     <value>4</value>
1639                 </op>
1640                 <value>8</value>
1641             </op>
1642         </list>
1643     </struct>
1644
1645     <struct name="XIDeviceInfo">
1646         <field type="DeviceId" name="deviceid" altenum="Device" />
1647         <field type="CARD16"   name="type" enum="DeviceType" />
1648         <field type="DeviceId" name="attachment" altenum="Device" />
1649         <field type="CARD16"   name="num_classes" />
1650         <field type="CARD16"   name="name_len" />
1651         <field type="BOOL"     name="enabled" />
1652         <pad bytes="1" />
1653         <list type="char" name="name">
1654             <fieldref>name_len</fieldref>
1655         </list>
1656         <pad align="4" />
1657         <list type="DeviceClass" name="classes">
1658             <fieldref>num_classes</fieldref>
1659         </list>
1660     </struct>
1661
1662     <request name="XIQueryDevice" opcode="48">
1663         <field type="DeviceId" name="deviceid" altenum="Device" />
1664         <pad bytes="2" />
1665         <reply>
1666             <pad bytes="1" />
1667             <field type="CARD16" name="num_infos" />
1668             <pad bytes="22" />
1669             <list type="XIDeviceInfo" name="infos">
1670                 <fieldref>num_infos</fieldref>
1671             </list>
1672         </reply>
1673     </request>
1674
1675     <!-- XISetFocus -->
1676
1677     <request name="XISetFocus" opcode="49">
1678         <field type="WINDOW"    name="window" />
1679         <field type="TIMESTAMP" name="time" altenum="Time" />
1680         <field type="DeviceId"  name="deviceid" altenum="Device" />
1681         <pad bytes="2" />
1682     </request>
1683
1684     <!-- XIGetFocus -->
1685
1686     <request name="XIGetFocus" opcode="50">
1687         <field type="DeviceId" name="deviceid" altenum="Device" />
1688         <pad bytes="2" />
1689         <reply>
1690             <pad bytes="1" />
1691             <field type="WINDOW" name="focus" />
1692             <pad bytes="20" />
1693         </reply>
1694     </request>
1695
1696     <!-- XIGrabDevice -->
1697
1698     <enum name="GrabOwner">
1699         <item name="NoOwner"> <value>0</value> </item>
1700         <item name="Owner">   <value>1</value> </item>
1701     </enum>
1702
1703     <request name="XIGrabDevice" opcode="51">
1704         <field type="WINDOW"    name="window" />
1705         <field type="TIMESTAMP" name="time" altenum="Time" />
1706         <field type="CURSOR"    name="cursor" />
1707         <field type="DeviceId"  name="deviceid" altenum="Device" />
1708         <field type="CARD8"     name="mode" enum="GrabMode" />
1709         <field type="CARD8"     name="paired_device_mode" enum="GrabMode" />
1710         <field type="BOOL"      name="owner_events" enum="GrabOwner" />
1711         <pad bytes="1" />
1712         <field type="CARD16"    name="mask_len" />
1713         <list type="CARD32" name="mask">
1714             <fieldref>mask_len</fieldref>
1715         </list>
1716         <reply>
1717             <pad bytes="1" />
1718             <field type="CARD8" name="status" enum="GrabStatus" />
1719             <pad bytes="23" />
1720         </reply>
1721     </request>
1722
1723     <!-- XIUngrabDevice -->
1724
1725     <request name="XIUngrabDevice" opcode="52">
1726         <field type="TIMESTAMP" name="time" altenum="Time" />
1727         <field type="DeviceId" name="deviceid" altenum="Device" />
1728         <pad bytes="2" />
1729     </request>
1730
1731     <!-- XIAllowEvents -->
1732
1733     <enum name="EventMode">
1734         <item name="AsyncDevice">       <value>0</value> </item>
1735         <item name="SyncDevice">        <value>1</value> </item>
1736         <item name="ReplayDevice">      <value>2</value> </item>
1737         <item name="AsyncPairedDevice"> <value>3</value> </item>
1738         <item name="AsyncPair">         <value>4</value> </item>
1739         <item name="SyncPair">          <value>5</value> </item>
1740         <item name="AcceptTouch">       <value>6</value> </item>
1741         <item name="RejectTouch">       <value>7</value> </item>
1742     </enum>
1743
1744     <request name="XIAllowEvents" opcode="53">
1745         <field type="TIMESTAMP" name="time" altenum="Time" />
1746         <field type="DeviceId"  name="deviceid" altenum="Device" />
1747         <field type="CARD8"     name="event_mode" enum="EventMode" />
1748         <pad bytes="1" />
1749         <field type="CARD32"    name="touchid" />
1750         <field type="WINDOW"    name="grab_window" />
1751     </request>
1752
1753     <!-- XIPassiveGrabDevice -->
1754
1755     <enum name="GrabMode22">
1756         <item name="Sync">  <value>0</value> </item>
1757         <item name="Async"> <value>1</value> </item>
1758         <item name="Touch"> <value>2</value> </item>
1759     </enum>
1760
1761     <enum name="GrabType">
1762         <item name="Button">     <value>0</value> </item>
1763         <item name="Keycode">    <value>1</value> </item>
1764         <item name="Enter">      <value>2</value> </item>
1765         <item name="FocusIn">    <value>3</value> </item>
1766         <item name="TouchBegin"> <value>4</value> </item>
1767     </enum>
1768
1769     <enum name="ModifierMask">
1770         <item name="Any"> <bit>31</bit> </item>
1771     </enum>
1772
1773     <struct name="GrabModifierInfo">
1774         <field type="CARD32" name="modifiers" altenum="ModifierMask" />
1775         <field type="CARD8"  name="status" enum="GrabStatus" />
1776         <pad bytes="3" />
1777     </struct>
1778
1779     <request name="XIPassiveGrabDevice" opcode="54">
1780         <!-- field "time" is unused and its value is undefined -->
1781         <field type="TIMESTAMP" name="time" altenum="Time" />
1782         <field type="WINDOW"    name="grab_window" />
1783         <field type="CURSOR"    name="cursor" />
1784         <field type="CARD32"    name="detail" />
1785         <field type="DeviceId"  name="deviceid" altenum="Device" />
1786         <field type="CARD16"    name="num_modifiers" />
1787         <field type="CARD16"    name="mask_len" />
1788         <field type="CARD8"     name="grab_type" enum="GrabType" />
1789         <field type="CARD8"     name="grab_mode" enum="GrabMode22" />
1790         <field type="CARD8"     name="paired_device_mode" enum="GrabMode" />
1791         <field type="BOOL"      name="owner_events" enum="GrabOwner" />
1792         <pad bytes="2" />
1793         <list type="CARD32" name="mask">
1794             <fieldref>mask_len</fieldref>
1795         </list>
1796         <list type="CARD32" name="modifiers">
1797             <fieldref>num_modifiers</fieldref>
1798         </list>
1799         <reply>
1800             <pad bytes="1" />
1801             <field type="CARD16" name="num_modifiers" />
1802             <pad bytes="22" />
1803             <list type="GrabModifierInfo" name="modifiers">
1804                 <fieldref>num_modifiers</fieldref>
1805             </list>
1806         </reply>
1807     </request>
1808
1809     <!-- XIPassiveUngrabDevice -->
1810
1811     <request name="XIPassiveUngrabDevice" opcode="55">
1812         <field type="WINDOW"   name="grab_window" />
1813         <field type="CARD32"   name="detail" />
1814         <field type="DeviceId" name="deviceid" altenum="Device" />
1815         <field type="CARD16"   name="num_modifiers" />
1816         <field type="CARD8"    name="grab_type" enum="GrabType" />
1817         <pad bytes="3" />
1818         <list type="CARD32" name="modifiers">
1819             <fieldref>num_modifiers</fieldref>
1820         </list>
1821     </request>
1822
1823     <!-- XIListProperties -->
1824
1825     <request name="XIListProperties" opcode="56">
1826         <field type="DeviceId" name="deviceid" altenum="Device" />
1827         <pad bytes="2" />
1828         <reply>
1829             <pad bytes="1" />
1830             <field type="CARD16" name="num_properties" />
1831             <pad bytes="22" />
1832             <list type="ATOM" name="properties">
1833                 <fieldref>num_properties</fieldref>
1834             </list>
1835         </reply>
1836     </request>
1837
1838     <!-- XIChangeProperty -->
1839
1840     <request name="XIChangeProperty" opcode="57">
1841         <field type="DeviceId" name="deviceid" altenum="Device" />
1842         <field type="CARD8"    name="mode" enum="PropMode" />
1843         <field type="CARD8"    name="format" enum="PropertyFormat" />
1844         <field type="ATOM"     name="property" />
1845         <field type="ATOM"     name="type" />
1846         <field type="CARD32"   name="num_items" />
1847         <switch name="items">
1848             <fieldref>format</fieldref>
1849             <!-- <bitcase> is not correct, this would need <cases>s.
1850                  It works in that case, because PropertyFormat items can be
1851                  distinguished exactly as their values don't have equal bits.
1852             -->
1853             <bitcase>
1854                 <enumref ref="PropertyFormat">8Bits</enumref>
1855                 <list type="CARD8" name="data8">
1856                     <fieldref>num_items</fieldref>
1857                 </list>
1858             </bitcase>
1859             <bitcase>
1860                 <enumref ref="PropertyFormat">16Bits</enumref>
1861                 <list type="CARD16" name="data16">
1862                     <fieldref>num_items</fieldref>
1863                 </list>
1864             </bitcase>
1865             <bitcase>
1866                 <enumref ref="PropertyFormat">32Bits</enumref>
1867                 <list type="CARD32" name="data32">
1868                     <fieldref>num_items</fieldref>
1869                 </list>
1870             </bitcase>
1871         </switch>
1872     </request>
1873
1874     <!-- XIDeleteProperty -->
1875
1876     <request name="XIDeleteProperty" opcode="58">
1877         <field type="DeviceId" name="deviceid" altenum="Device" />
1878         <pad bytes="2" />
1879         <field type="ATOM"     name="property" />
1880     </request>
1881
1882     <!-- XIGetProperty -->
1883
1884     <request name="XIGetProperty" opcode="59">
1885         <field type="DeviceId" name="deviceid" altenum="Device" />
1886         <field type="BOOL"     name="delete" />
1887         <pad bytes="1" />
1888         <field type="ATOM"     name="property" />
1889         <field type="ATOM"     name="type" />
1890         <field type="CARD32"   name="offset" />
1891         <field type="CARD32"   name="len" />
1892         <reply>
1893             <pad bytes="1" />
1894             <field type="ATOM"   name="type" />
1895             <field type="CARD32" name="bytes_after" />
1896             <field type="CARD32" name="num_items" />
1897             <field type="CARD8"  name="format" enum="PropertyFormat" />
1898             <pad bytes="11" />
1899             <switch name="items">
1900                 <fieldref>format</fieldref>
1901                 <!-- <bitcase> is not correct, this would need <cases>s.
1902                      It works in that case, because PropertyFormat items can be
1903                      distinguished exactly as their values don't have equal bits.
1904                 -->
1905                 <bitcase>
1906                     <enumref ref="PropertyFormat">8Bits</enumref>
1907                     <list type="CARD8" name="data8">
1908                         <fieldref>num_items</fieldref>
1909                     </list>
1910                     <pad align="4" />
1911                 </bitcase>
1912                 <bitcase>
1913                     <enumref ref="PropertyFormat">16Bits</enumref>
1914                     <list type="CARD16" name="data16">
1915                         <fieldref>num_items</fieldref>
1916                     </list>
1917                     <pad align="4" />
1918                 </bitcase>
1919                 <bitcase>
1920                     <enumref ref="PropertyFormat">32Bits</enumref>
1921                     <list type="CARD32" name="data32">
1922                         <fieldref>num_items</fieldref>
1923                     </list>
1924                 </bitcase>
1925             </switch>
1926         </reply>
1927     </request>
1928
1929     <!-- XIGetSelectedEvents -->
1930
1931     <request name="XIGetSelectedEvents" opcode="60">
1932         <field type="WINDOW" name="window" />
1933         <reply>
1934             <pad bytes="1" />
1935             <field type="CARD16" name="num_masks" />
1936             <pad bytes="22" />
1937             <list type="EventMask" name="masks">
1938                 <fieldref>num_masks</fieldref>
1939             </list>
1940         </reply>
1941     </request>
1942
1943     <!-- ⋅⋅⋅ Requests (v2.3) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1944
1945     <!-- XIBarrierReleasePointer -->
1946
1947     <struct name="BarrierReleasePointerInfo">
1948         <field type="DeviceId" name="deviceid" />
1949         <pad bytes="2" />
1950         <field type="BARRIER"  name="barrier" />
1951         <field type="CARD32"   name="eventid" />
1952     </struct>
1953
1954     <request name="XIBarrierReleasePointer" opcode="61">
1955         <field type="CARD32" name="num_barriers" />
1956         <list type="BarrierReleasePointerInfo" name="barriers">
1957             <fieldref>num_barriers</fieldref>
1958         </list>
1959     </request>
1960
1961     <!-- ⋅⋅⋅ Events (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1962     <!-- Notes:
1963          - A 'len' field in a v1++ structure is in bytes.
1964     -->
1965
1966     <event name="DeviceValuator" number="0">
1967         <field type="CARD8"  name="device_id" />
1968         <field type="CARD16" name="device_state" />
1969         <field type="CARD8"  name="num_valuators" />
1970         <field type="CARD8"  name="first_valuator" />
1971         <list type="INT32"   name="valuators">
1972             <value>6</value>
1973         </list>
1974     </event>
1975
1976     <!-- the highest bit in a CARD8 device_id-field indicates that more
1977         events will follow -->
1978     <enum name="MoreEventsMask">
1979         <item name="MoreEvents"> <bit>7</bit> </item> <!-- 0x80 -->
1980     </enum>
1981
1982     <event name="DeviceKeyPress" number="1">
1983         <field type="BYTE"      name="detail" />
1984         <field type="TIMESTAMP" name="time" />
1985         <field type="WINDOW"    name="root" />
1986         <field type="WINDOW"    name="event" />
1987         <field type="WINDOW"    name="child" altenum="Window" />
1988         <field type="INT16"     name="root_x" />
1989         <field type="INT16"     name="root_y" />
1990         <field type="INT16"     name="event_x" />
1991         <field type="INT16"     name="event_y" />
1992         <field type="CARD16"    name="state" mask="KeyButMask" />
1993         <field type="BOOL"      name="same_screen" />
1994         <field type="CARD8"     name="device_id" altmask="MoreEventsMask" />
1995     </event>
1996
1997     <eventcopy name="DeviceKeyRelease"    number="2" ref="DeviceKeyPress" />
1998     <eventcopy name="DeviceButtonPress"   number="3" ref="DeviceKeyPress" />
1999     <eventcopy name="DeviceButtonRelease" number="4" ref="DeviceKeyPress" />
2000     <eventcopy name="DeviceMotionNotify"  number="5" ref="DeviceKeyPress" />
2001
2002     <event name="DeviceFocusIn" number="6">
2003         <field type="BYTE"      name="detail" enum="xproto:NotifyDetail" />
2004         <field type="TIMESTAMP" name="time" />
2005         <field type="WINDOW"    name="window" />
2006         <field type="BYTE"      name="mode" enum="xproto:NotifyMode" />
2007         <field type="CARD8"     name="device_id" />
2008         <pad bytes="18" />
2009     </event>
2010
2011     <eventcopy name="DeviceFocusOut" number="7" ref="DeviceFocusIn" />
2012     <eventcopy name="ProximityIn"    number="8" ref="DeviceKeyPress" />
2013     <eventcopy name="ProximityOut"   number="9" ref="DeviceKeyPress" />
2014
2015     <enum name="ClassesReportedMask">
2016         <item name="OutOfProximity">     <bit>7</bit> </item> <!-- 0x80 -->
2017             <!-- 0 = InProxmity, 1 = OutOfProximity -->
2018
2019         <item name="DeviceModeAbsolute"> <bit>6</bit> </item> <!-- 0x40 -->
2020             <!-- 0 = Relative, 1 = Absolute -->
2021
2022         <item name="ReportingValuators"> <bit>2</bit> </item> <!-- 0x04 -->
2023         <item name="ReportingButtons">   <bit>1</bit> </item> <!-- 0x02 -->
2024         <item name="ReportingKeys">      <bit>0</bit> </item> <!-- 0x01 -->
2025     </enum>
2026
2027     <event name="DeviceStateNotify" number="10">
2028         <field type="BYTE"      name="device_id" altmask="MoreEventsMask" />
2029         <field type="TIMESTAMP" name="time" />
2030         <field type="CARD8"     name="num_keys" />
2031         <field type="CARD8"     name="num_buttons" />
2032         <field type="CARD8"     name="num_valuators" />
2033         <field type="CARD8"     name="classes_reported" mask="ClassesReportedMask" />
2034         <list type="CARD8"      name="buttons">
2035             <value>4</value>
2036         </list>
2037         <list type="CARD8" name="keys">
2038             <value>4</value>
2039         </list>
2040         <list type="CARD32" name="valuators">
2041             <value>3</value>
2042         </list>
2043     </event>
2044
2045     <event name="DeviceMappingNotify" number="11">
2046         <field type="BYTE"    name="device_id" />
2047         <field type="CARD8"   name="request" enum="Mapping" />
2048         <field type="KeyCode" name="first_keycode" />
2049         <field type="CARD8"   name="count" />
2050         <pad bytes="1" />
2051         <field type="TIMESTAMP" name="time" />
2052         <pad bytes="20" />
2053     </event>
2054
2055     <enum name="ChangeDevice">
2056         <item name="NewPointer">  <value>0</value> </item>
2057         <item name="NewKeyboard"> <value>1</value> </item>
2058     </enum>
2059
2060     <event name="ChangeDeviceNotify" number="12">
2061         <field type="BYTE"      name="device_id" />
2062         <field type="TIMESTAMP" name="time" />
2063         <field type="CARD8"     name="request" enum="ChangeDevice" />
2064         <pad bytes="23" />
2065     </event>
2066
2067     <event name="DeviceKeyStateNotify" number="13">
2068         <field type="BYTE" name="device_id" altmask="MoreEventsMask" />
2069         <list type="CARD8" name="keys">
2070             <value>28</value>
2071         </list>
2072     </event>
2073
2074     <event name="DeviceButtonStateNotify" number="14">
2075         <field type="BYTE" name="device_id" altmask="MoreEventsMask" />
2076         <list type="CARD8" name="buttons">
2077             <value>28</value>
2078         </list>
2079     </event>
2080
2081     <!-- ⋅⋅⋅ Events (v1.4) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2082
2083     <enum name="DeviceChange">
2084         <item name="Added">          <value>0</value> </item>
2085         <item name="Removed">        <value>1</value> </item>
2086         <item name="Enabled">        <value>2</value> </item>
2087         <item name="Disabled">       <value>3</value> </item>
2088         <item name="Unrecoverable">  <value>4</value> </item>
2089         <item name="ControlChanged"> <value>5</value> </item>
2090     </enum>
2091
2092     <event name="DevicePresenceNotify" number="15">
2093         <pad bytes="1" />
2094         <field type="TIMESTAMP" name="time" />
2095         <field type="BYTE"      name="devchange" enum="DeviceChange" />
2096         <field type="BYTE"      name="device_id" />
2097         <field type="CARD16"    name="control" />
2098         <pad bytes="20" />
2099     </event>
2100
2101     <!-- ⋅⋅⋅ Events (v1.5) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2102
2103     <event name="DevicePropertyNotify" number="16">
2104         <field type="BYTE"      name="state" enum="Property" />
2105         <field type="TIMESTAMP" name="time" />
2106         <field type="ATOM"      name="property" />
2107         <pad bytes="19" />
2108         <field type="CARD8"     name="device_id" />
2109     </event>
2110
2111     <!-- ⋅⋅⋅ Events (v2.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2112     <!-- Notes:
2113          - A 'len' field in a v2++ structure is in 4 byte units.
2114     -->
2115
2116     <enum name="ChangeReason">
2117         <item name="SlaveSwitch">  <value>1</value> </item>
2118         <item name="DeviceChange"> <value>2</value> </item>
2119     </enum>
2120
2121     <event name="DeviceChanged" number="1" xge="true">
2122         <field type="DeviceId"  name="deviceid" altenum="Device" />
2123         <field type="TIMESTAMP" name="time" altenum="Time" />
2124         <!-- event specific fields -->
2125         <field type="CARD16"    name="num_classes" />
2126         <field type="DeviceId"  name="sourceid" altenum="Device" />
2127         <field type="CARD8"     name="reason" enum="ChangeReason" />
2128         <pad bytes="11" />
2129         <!-- 32 byte boundary -->
2130         <list type="DeviceClass" name="classes">
2131             <fieldref>num_classes</fieldref>
2132         </list>
2133     </event>
2134
2135     <enum name="KeyEventFlags">
2136         <item name="KeyRepeat"> <bit>16</bit> </item>
2137     </enum>
2138
2139     <event name="KeyPress" number="2" xge="true">
2140         <field type="DeviceId"  name="deviceid" altenum="Device" />
2141         <field type="TIMESTAMP" name="time" altenum="Time" />
2142         <!-- event specific fields -->
2143         <field type="CARD32"    name="detail" />
2144         <field type="WINDOW"    name="root" />
2145         <field type="WINDOW"    name="event" />
2146         <field type="WINDOW"    name="child" />
2147         <!-- 32 byte boundary -->
2148         <field type="FP1616"    name="root_x" />
2149         <field type="FP1616"    name="root_y" />
2150         <field type="FP1616"    name="event_x" />
2151         <field type="FP1616"    name="event_y" />
2152         <field type="CARD16"    name="buttons_len" />
2153         <field type="CARD16"    name="valuators_len" />
2154         <field type="DeviceId"  name="sourceid" altenum="Device" />
2155         <pad bytes="2" />
2156         <field type="CARD32"       name="flags" mask="KeyEventFlags" />
2157         <field type="ModifierInfo" name="mods" />
2158         <field type="GroupInfo"    name="group" />
2159         <list type="CARD32" name="button_mask">
2160             <fieldref>buttons_len</fieldref>
2161         </list>
2162         <list type="CARD32" name="valuator_mask">
2163             <fieldref>valuators_len</fieldref>
2164         </list>
2165         <!-- Uninterpreted: list (axisvalues) of FP3232,
2166                             length is <popcount> on valuator_mask list -->
2167     </event>
2168
2169     <eventcopy name="KeyRelease" number="3" ref="KeyPress" />
2170
2171     <enum name="PointerEventFlags">
2172         <item name="PointerEmulated"> <bit>16</bit> </item>
2173     </enum>
2174
2175     <event name="ButtonPress" number="4" xge="true">
2176         <field type="DeviceId"  name="deviceid" altenum="Device" />
2177         <field type="TIMESTAMP" name="time" altenum="Time" />
2178         <!-- event specific fields -->
2179         <field type="CARD32"    name="detail" />
2180         <field type="WINDOW"    name="root" />
2181         <field type="WINDOW"    name="event" />
2182         <field type="WINDOW"    name="child" />
2183         <!-- 32 byte boundary -->
2184         <field type="FP1616"    name="root_x" />
2185         <field type="FP1616"    name="root_y" />
2186         <field type="FP1616"    name="event_x" />
2187         <field type="FP1616"    name="event_y" />
2188         <field type="CARD16"    name="buttons_len" />
2189         <field type="CARD16"    name="valuators_len" />
2190         <field type="DeviceId"  name="sourceid" altenum="Device" />
2191         <pad bytes="2" />
2192         <field type="CARD32"       name="flags" mask="PointerEventFlags" />
2193         <field type="ModifierInfo" name="mods" />
2194         <field type="GroupInfo"    name="group" />
2195         <list type="CARD32" name="button_mask">
2196             <fieldref>buttons_len</fieldref>
2197         </list>
2198         <list type="CARD32" name="valuator_mask">
2199             <fieldref>valuators_len</fieldref>
2200         </list>
2201         <!-- Uninterpreted: list (axisvalues) of FP3232,
2202                             length is <popcount> on valuator_mask list -->
2203     </event>
2204
2205     <eventcopy name="ButtonRelease" number="5" ref="ButtonPress" />
2206     <eventcopy name="Motion"        number="6" ref="ButtonPress" />
2207
2208     <enum name="NotifyMode">
2209         <item name="Normal">        <value>0</value> </item>
2210         <item name="Grab">          <value>1</value> </item>
2211         <item name="Ungrab">        <value>2</value> </item>
2212         <item name="WhileGrabbed">  <value>3</value> </item>
2213         <item name="PassiveGrab">   <value>4</value> </item>
2214         <item name="PassiveUngrab"> <value>5</value> </item>
2215     </enum>
2216
2217     <enum name="NotifyDetail">
2218         <item name="Ancestor">         <value>0</value> </item>
2219         <item name="Virtual">          <value>1</value> </item>
2220         <item name="Inferior">         <value>2</value> </item>
2221         <item name="Nonlinear">        <value>3</value> </item>
2222         <item name="NonlinearVirtual"> <value>4</value> </item>
2223         <item name="Pointer">          <value>5</value> </item>
2224         <item name="PointerRoot">      <value>6</value> </item>
2225         <item name="None">             <value>7</value> </item>
2226     </enum>
2227
2228     <event name="Enter" number="7" xge="true">
2229         <field type="DeviceId"  name="deviceid" altenum="Device" />
2230         <field type="TIMESTAMP" name="time" altenum="Time" />
2231         <!-- event specific fields -->
2232         <field type="DeviceId"  name="sourceid" altenum="Device" />
2233         <field type="CARD8"     name="mode" enum="xinput:NotifyMode" />
2234         <field type="CARD8"     name="detail" enum="xinput:NotifyDetail" />
2235         <field type="WINDOW"    name="root" />
2236         <field type="WINDOW"    name="event" />
2237         <field type="WINDOW"    name="child" />
2238         <!-- 32 byte boundary -->
2239         <field type="FP1616"       name="root_x" />
2240         <field type="FP1616"       name="root_y" />
2241         <field type="FP1616"       name="event_x" />
2242         <field type="FP1616"       name="event_y" />
2243         <field type="BOOL"         name="same_screen" />
2244         <field type="BOOL"         name="focus" />
2245         <field type="CARD16"       name="buttons_len" />
2246         <field type="ModifierInfo" name="mods" />
2247         <field type="GroupInfo"    name="group" />
2248         <list type="CARD32" name="buttons">
2249             <fieldref>buttons_len</fieldref>
2250         </list>
2251     </event>
2252
2253     <eventcopy name="Leave"    number="8" ref="Enter" />
2254     <eventcopy name="FocusIn"  number="9" ref="Enter" />
2255     <eventcopy name="FocusOut" number="10" ref="Enter" />
2256
2257     <enum name="HierarchyMask">
2258         <item name="MasterAdded">    <bit>0</bit> </item>
2259         <item name="MasterRemoved">  <bit>1</bit> </item>
2260         <item name="SlaveAdded">     <bit>2</bit> </item>
2261         <item name="SlaveRemoved">   <bit>3</bit> </item>
2262         <item name="SlaveAttached">  <bit>4</bit> </item>
2263         <item name="SlaveDetached">  <bit>5</bit> </item>
2264         <item name="DeviceEnabled">  <bit>6</bit> </item>
2265         <item name="DeviceDisabled"> <bit>7</bit> </item>
2266     </enum>
2267
2268     <struct name="HierarchyInfo">
2269         <field type="DeviceId" name="deviceid" altenum="Device" />
2270         <field type="DeviceId" name="attachment" altenum="Device" />
2271         <field type="CARD8"    name="type" enum="DeviceType"/>
2272         <field type="BOOL"     name="enabled" />
2273         <pad bytes="2" />
2274         <field type="CARD32"   name="flags" mask="HierarchyMask" />
2275     </struct>
2276
2277     <event name="Hierarchy" number="11" xge="true">
2278         <field type="DeviceId"  name="deviceid" altenum="Device" />
2279         <field type="TIMESTAMP" name="time" altenum="Time" />
2280         <!-- event specific fields -->
2281         <field type="CARD32"    name="flags" mask="HierarchyMask" />
2282         <field type="CARD16"    name="num_infos" />
2283         <pad bytes="10" />
2284         <!-- 32 byte boundary -->
2285         <list type="HierarchyInfo" name="infos">
2286             <fieldref>num_infos</fieldref>
2287         </list>
2288     </event>
2289
2290     <enum name="PropertyFlag">
2291         <item name="Deleted">  <value>0</value> </item>
2292         <item name="Created">  <value>1</value> </item>
2293         <item name="Modified"> <value>2</value> </item>
2294     </enum>
2295
2296     <event name="Property" number="12" xge="true">
2297         <field type="DeviceId"  name="deviceid" altenum="Device" />
2298         <field type="TIMESTAMP" name="time" altenum="Time" />
2299         <!-- event specific fields -->
2300         <field type="ATOM"      name="property" />
2301         <field type="CARD8"     name="what" enum="PropertyFlag" />
2302         <pad bytes="11" />
2303         <!-- 32 byte boundary -->
2304     </event>
2305
2306     <!-- ⋅⋅⋅ Events (v2.1) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2307
2308     <event name="RawKeyPress" number="13" xge="true">
2309         <field type="DeviceId"  name="deviceid" altenum="Device" />
2310         <field type="TIMESTAMP" name="time" altenum="Time" />
2311         <!-- event specific fields -->
2312         <field type="CARD32"    name="detail" />
2313         <field type="DeviceId"  name="sourceid" />
2314         <field type="CARD16"    name="valuators_len" />
2315         <field type="CARD32"    name="flags" mask="KeyEventFlags"/>
2316         <pad bytes="4" />
2317         <!-- 32 byte boundary -->
2318         <list type="CARD32" name="valuator_mask">
2319             <fieldref>valuators_len</fieldref>
2320         </list>
2321         <!-- Uninterpreted: list (axisvalues) of FP3232,
2322                             length is <popcount> on valuator_mask list -->
2323         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2324                             length is <popcount> on valuator_mask list -->
2325     </event>
2326
2327     <eventcopy name="RawKeyRelease" number="14" ref="RawKeyPress" />
2328
2329     <event name="RawButtonPress" number="15" xge="true">
2330         <field type="DeviceId"  name="deviceid" altenum="Device" />
2331         <field type="TIMESTAMP" name="time" altenum="Time" />
2332         <!-- event specific fields -->
2333         <field type="CARD32"    name="detail" />
2334         <field type="DeviceId"  name="sourceid" />
2335         <field type="CARD16"    name="valuators_len" />
2336         <field type="CARD32"    name="flags" mask="PointerEventFlags"/>
2337         <pad bytes="4" />
2338         <!-- 32 byte boundary -->
2339         <list type="CARD32" name="valuator_mask">
2340             <fieldref>valuators_len</fieldref>
2341         </list>
2342         <!-- Uninterpreted: list (axisvalues) of FP3232,
2343                             length is <popcount> on valuator_mask list -->
2344         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2345                             length is <popcount> on valuator_mask list -->
2346     </event>
2347
2348     <eventcopy name="RawButtonRelease" number="16" ref="RawButtonPress" />
2349     <eventcopy name="RawMotion"        number="17" ref="RawButtonPress" />
2350
2351     <!-- ⋅⋅⋅ Events (v2.2) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2352
2353     <enum name="TouchEventFlags">
2354         <item name="TouchPendingEnd">       <bit>16</bit> </item>
2355         <item name="TouchEmulatingPointer"> <bit>17</bit> </item>
2356     </enum>
2357
2358     <event name="TouchBegin" number="18" xge="true">
2359         <field type="DeviceId"  name="deviceid" altenum="Device" />
2360         <field type="TIMESTAMP" name="time" altenum="Time" />
2361         <!-- event specific fields -->
2362         <field type="CARD32"    name="detail" />
2363         <field type="WINDOW"    name="root" />
2364         <field type="WINDOW"    name="event" />
2365         <field type="WINDOW"    name="child" />
2366         <!-- 32 byte boundary -->
2367         <field type="FP1616"    name="root_x" />
2368         <field type="FP1616"    name="root_y" />
2369         <field type="FP1616"    name="event_x" />
2370         <field type="FP1616"    name="event_y" />
2371         <field type="CARD16"    name="buttons_len" />
2372         <field type="CARD16"    name="valuators_len" />
2373         <field type="DeviceId"  name="sourceid" altenum="Device" />
2374         <pad bytes="2" />
2375         <field type="CARD32"       name="flags" mask="TouchEventFlags" />
2376         <field type="ModifierInfo" name="mods" />
2377         <field type="GroupInfo"    name="group" />
2378         <list type="CARD32" name="button_mask">
2379             <fieldref>buttons_len</fieldref>
2380         </list>
2381         <list type="CARD32" name="valuator_mask">
2382             <fieldref>valuators_len</fieldref>
2383         </list>
2384         <!-- Uninterpreted: list (axisvalues) of FP3232,
2385                             length is <popcount> on valuator_mask list -->
2386     </event>
2387
2388     <eventcopy name="TouchUpdate" number="19" ref="TouchBegin" />
2389     <eventcopy name="TouchEnd"    number="20" ref="TouchBegin" />
2390
2391     <enum name="TouchOwnershipFlags">
2392         <!-- XXX: Remove this enum? Currently, no flag is defined. -->
2393         <item name="None"> <value>0</value> </item>
2394     </enum>
2395
2396     <event name="TouchOwnership" number="21" xge="true">
2397         <field type="DeviceId"  name="deviceid" altenum="Device" />
2398         <field type="TIMESTAMP" name="time" altenum="Time" />
2399         <!-- event specific fields -->
2400         <field type="CARD32"    name="touchid" />
2401         <field type="WINDOW"    name="root" />
2402         <field type="WINDOW"    name="event" />
2403         <field type="WINDOW"    name="child" />
2404         <!-- 32 byte boundary -->
2405         <field type="DeviceId"  name="sourceid" altenum="Device" />
2406         <pad bytes="2" />
2407         <field type="CARD32"    name="flags" enum="TouchOwnershipFlags" />
2408         <pad bytes="8" />
2409     </event>
2410
2411     <event name="RawTouchBegin" number="22" xge="true">
2412         <field type="DeviceId"  name="deviceid" altenum="Device" />
2413         <field type="TIMESTAMP" name="time" altenum="Time" />
2414         <!-- event specific fields -->
2415         <field type="CARD32"    name="detail" />
2416         <field type="DeviceId"  name="sourceid" />
2417         <field type="CARD16"    name="valuators_len" />
2418         <field type="CARD32"    name="flags" mask="TouchEventFlags"/>
2419         <pad bytes="4" />
2420         <!-- 32 byte boundary -->
2421         <list type="CARD32" name="valuator_mask">
2422             <fieldref>valuators_len</fieldref>
2423         </list>
2424         <!-- Uninterpreted: list (axisvalues) of FP3232,
2425                             length is <popcount> on valuator_mask list -->
2426         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2427                             length is <popcount> on valuator_mask list -->
2428     </event>
2429
2430     <eventcopy name="RawTouchUpdate" number="23" ref="RawTouchBegin" />
2431     <eventcopy name="RawTouchEnd"    number="24" ref="RawTouchBegin" />
2432
2433     <!-- ⋅⋅⋅ Events (v2.3) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2434
2435     <enum name="BarrierFlags">
2436         <item name="PointerReleased"> <bit>0</bit> </item>
2437         <item name="DeviceIsGrabbed"> <bit>1</bit> </item>
2438     </enum>
2439
2440     <event name="BarrierHit" number="25" xge="true">
2441         <field type="DeviceId"  name="deviceid" altenum="Device" />
2442         <field type="TIMESTAMP" name="time" altenum="Time" />
2443         <!-- event specific fields -->
2444         <field type="CARD32"    name="eventid" />
2445         <field type="WINDOW"    name="root" />
2446         <field type="WINDOW"    name="event" />
2447         <field type="BARRIER"   name="barrier" />
2448         <!-- 32 byte boundary -->
2449         <field type="CARD32"    name="dtime" />
2450         <field type="CARD32"    name="flags" mask="BarrierFlags" />
2451         <field type="DeviceId"  name="sourceid" altenum="Device" />
2452         <pad bytes="2" />
2453         <field type="FP1616"    name="root_x" />
2454         <field type="FP1616"    name="root_y" />
2455         <field type="FP3232"    name="dx" />
2456         <field type="FP3232"    name="dy" />
2457     </event>
2458
2459     <eventcopy name="BarrierLeave" number="26" ref="BarrierHit" />
2460
2461     <!-- ⋅⋅⋅ Errors (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2462
2463     <error name="Device"     number="0" />
2464     <error name="Event"      number="1" />
2465     <error name="Mode"       number="2" />
2466     <error name="DeviceBusy" number="3" />
2467     <error name="Class"      number="4" />
2468
2469 </xcb>