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