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