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