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