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