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