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