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="CARD32" 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         <field type="CARD8" name="num_items" />
 874         <pad bytes="1" />
 875         <list type="CARD8" name="uninterpreted_data">
 876             <op op="-">
 877                 <fieldref>len</fieldref>
 878                 <value>4</value>
 879             </op>
 880         </list>
 881     </struct>
 882
 883     <request name="QueryDeviceState" opcode="30">
 884         <field type="CARD8" name="device_id" />
 885         <pad bytes="3" />
 886         <reply>
 887             <field type="CARD8" name="xi_reply_type" />
 888             <field type="CARD8" name="num_classes" />
 889             <pad bytes="23" />
 890             <list type="InputState" name="classes">
 891                 <fieldref>num_classes</fieldref>
 892             </list>
 893         </reply>
 894     </request>
 895
 896     <!-- SendExtensionEvent -->
 897
 898     <request name="SendExtensionEvent" opcode="31">
 899         <field type="WINDOW" name="destination" />
 900         <field type="CARD8"  name="device_id" />
 901         <field type="BOOL"   name="propagate" />
 902         <field type="CARD16" name="num_classes" />
 903         <field type="CARD8"  name="num_events" />
 904         <pad bytes="3" />
 905         <list type="CARD8" name="events">
 906             <op op="*">
 907                 <fieldref>num_events</fieldref>
 908                 <value>32</value>
 909             </op>
 910         </list>
 911         <list type="EventClass" name="classes">
 912             <fieldref>num_classes</fieldref>
 913         </list>
 914     </request>
 915
 916     <!-- DeviceBell -->
 917
 918     <request name="DeviceBell" opcode="32">
 919         <field type="CARD8" name="device_id" />
 920         <field type="CARD8" name="feedback_id" />
 921         <field type="CARD8" name="feedback_class" />
 922         <field type="INT8"  name="percent" />
 923     </request>
 924
 925     <!-- SetDeviceValuators -->
 926
 927     <request name="SetDeviceValuators" opcode="33">
 928         <field type="CARD8" name="device_id" />
 929         <field type="CARD8" name="first_valuator" />
 930         <field type="CARD8" name="num_valuators" />
 931         <pad bytes="1" />
 932         <list type="INT32" name="valuators">
 933             <fieldref>num_valuators</fieldref>
 934         </list>
 935         <reply>
 936             <field type="CARD8" name="xi_reply_type" />
 937             <field type="CARD8" name="status" enum="GrabStatus" />
 938             <pad bytes="23" />
 939         </reply>
 940     </request>
 941
 942     <!-- GetDeviceControl -->
 943
 944     <enum name="DeviceControl">
 945         <item name="resolution"> <value>1</value> </item>
 946         <item name="abs_calib">  <value>2</value> </item>
 947         <item name="core">       <value>3</value> </item>
 948         <item name="enable">     <value>4</value> </item>
 949         <item name="abs_area">   <value>5</value> </item>
 950     </enum>
 951
 952     <struct name="DeviceResolutionState">
 953         <field type="CARD16" name="control_id" enum="DeviceControl" />
 954         <field type="CARD16" name="len" />
 955         <field type="CARD32" name="num_valuators" />
 956         <list type="CARD32"  name="resolution_values">
 957             <fieldref>num_valuators</fieldref>
 958         </list>
 959         <list type="CARD32" name="resolution_min">
 960             <fieldref>num_valuators</fieldref>
 961         </list>
 962         <list type="CARD32" name="resolution_max">
 963             <fieldref>num_valuators</fieldref>
 964         </list>
 965     </struct>
 966
 967     <struct name="DeviceAbsCalibState">
 968         <field type="CARD16" name="control_id" enum="DeviceControl" />
 969         <field type="CARD16" name="len" />
 970         <field type="INT32"  name="min_x" />
 971         <field type="INT32"  name="max_x" />
 972         <field type="INT32"  name="min_y" />
 973         <field type="INT32"  name="max_y" />
 974         <field type="CARD32" name="flip_x" />
 975         <field type="CARD32" name="flip_y" />
 976         <field type="CARD32" name="rotation" />
 977         <field type="CARD32" name="button_threshold" />
 978     </struct>
 979
 980     <struct name="DeviceAbsAreaState">
 981         <field type="CARD16" name="control_id" enum="DeviceControl" />
 982         <field type="CARD16" name="len" />
 983         <field type="CARD32" name="offset_x" />
 984         <field type="CARD32" name="offset_y" />
 985         <field type="CARD32" name="width" />
 986         <field type="CARD32" name="height" />
 987         <field type="CARD32" name="screen" />
 988         <field type="CARD32" name="following" />
 989     </struct>
 990
 991     <struct name="DeviceCoreState">
 992         <field type="CARD16" name="control_id" enum="DeviceControl" />
 993         <field type="CARD16" name="len" />
 994         <field type="CARD8"  name="status" />
 995         <field type="CARD8"  name="iscore" />
 996         <pad bytes="2" />
 997     </struct>
 998
 999     <struct name="DeviceEnableState">
1000         <field type="CARD16" name="control_id" enum="DeviceControl" />
1001         <field type="CARD16" name="len" />
1002         <field type="CARD8"  name="enable" />
1003         <pad bytes="3" />
1004     </struct>
1005
1006     <struct name="DeviceState">
1007         <field type="CARD16" name="control_id" enum="DeviceControl" />
1008         <field type="CARD16" name="len" />
1009         <list type="CARD8" name="uninterpreted_data">
1010             <op op="-">
1011                 <fieldref>len</fieldref>
1012                 <value>4</value>
1013             </op>
1014         </list>
1015     </struct>
1016
1017     <request name="GetDeviceControl" opcode="34">
1018         <field type="CARD16" name="control_id" enum="DeviceControl" />
1019         <field type="CARD8"  name="device_id" />
1020         <pad bytes="1" />
1021         <reply>
1022             <field type="CARD8" name="xi_reply_type" />
1023             <field type="CARD8" name="status" altenum="GrabStatus" />
1024             <pad bytes="23" />
1025             <field type="DeviceState" name="control" />
1026         </reply>
1027     </request>
1028
1029     <!-- ChangeDeviceControl -->
1030
1031     <struct name="DeviceResolutionCtl">
1032         <field type="CARD16" name="control_id" enum="DeviceControl" />
1033         <field type="CARD16" name="len" />
1034         <field type="CARD8"  name="first_valuator" />
1035         <field type="CARD8"  name="num_valuators" />
1036         <pad bytes="2" />
1037         <list type="CARD32"  name="resolution_values">
1038             <fieldref>num_valuators</fieldref>
1039         </list>
1040     </struct>
1041
1042     <struct name="DeviceAbsCalibCtl">
1043         <field type="CARD16" name="control_id" enum="DeviceControl" />
1044         <field type="CARD16" name="len" />
1045         <field type="INT32"  name="min_x" />
1046         <field type="INT32"  name="max_x" />
1047         <field type="INT32"  name="min_y" />
1048         <field type="INT32"  name="max_y" />
1049         <field type="CARD32" name="flip_x" />
1050         <field type="CARD32" name="flip_y" />
1051         <field type="CARD32" name="rotation" />
1052         <field type="CARD32" name="button_threshold" />
1053     </struct>
1054
1055     <struct name="DeviceAbsAreaCtrl">
1056         <field type="CARD16" name="control_id" enum="DeviceControl" />
1057         <field type="CARD16" name="len" />
1058         <field type="CARD32" name="offset_x" />
1059         <field type="CARD32" name="offset_y" />
1060         <field type="INT32"  name="width" />
1061         <field type="INT32"  name="height" />
1062         <field type="INT32"  name="screen" />
1063         <field type="CARD32" name="following" />
1064     </struct>
1065
1066     <struct name="DeviceCoreCtrl">
1067         <field type="CARD16" name="control_id" enum="DeviceControl" />
1068         <field type="CARD16" name="len" />
1069         <field type="CARD8"  name="status" />
1070         <pad bytes="3" />
1071     </struct>
1072
1073     <struct name="DeviceEnableCtrl">
1074         <field type="CARD16" name="control_id" enum="DeviceControl" />
1075         <field type="CARD16" name="len" />
1076         <field type="CARD8"  name="enable" />
1077         <pad bytes="3" />
1078     </struct>
1079
1080     <struct name="DeviceCtl">
1081         <field type="CARD16" name="control_id" enum="DeviceControl" />
1082         <field type="CARD16" name="len" />
1083         <list type="CARD8" name="uninterpreted_data">
1084             <op op="-">
1085                 <fieldref>len</fieldref>
1086                 <value>4</value>
1087             </op>
1088         </list>
1089     </struct>
1090
1091     <request name="ChangeDeviceControl" opcode="35">
1092         <field type="CARD16" name="control_id" enum="DeviceControl" />
1093         <field type="CARD8"  name="device_id" />
1094         <pad bytes="1" />
1095         <field type="DeviceCtl" name="control" />
1096         <reply>
1097             <field type="CARD8" name="xi_reply_type" />
1098             <field type="CARD8" name="status" altenum="GrabStatus" />
1099             <pad bytes="23" />
1100         </reply>
1101     </request>
1102
1103     <!-- ⋅⋅⋅ Requests (v1.5) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1104
1105     <!-- ListDeviceProperties -->
1106
1107     <request name="ListDeviceProperties" opcode="36">
1108         <field type="CARD8"  name="device_id" />
1109         <pad bytes="3" />
1110         <reply>
1111             <field type="CARD8"  name="xi_reply_type" />
1112             <field type="CARD16" name="num_atoms" />
1113             <pad bytes="22" />
1114             <list type="ATOM" name="atoms">
1115                 <fieldref>num_atoms</fieldref>
1116             </list>
1117         </reply>
1118     </request>
1119
1120     <!-- ChangeDeviceProperty -->
1121
1122     <enum name="PropertyFormat">
1123         <item name="8Bits">  <value>8</value> </item>
1124         <item name="16Bits"> <value>16</value> </item>
1125         <item name="32Bits"> <value>32</value> </item>
1126     </enum>
1127
1128     <request name="ChangeDeviceProperty" opcode="37">
1129         <field type="ATOM"  name="property" />
1130         <field type="ATOM"  name="type" />
1131         <field type="CARD8" name="device_id" />
1132         <field type="CARD8" name="format" enum="PropertyFormat" />
1133         <field type="CARD8" name="mode" enum="PropMode" />
1134         <pad bytes="1" />
1135         <field type="CARD32" name="num_items" />
1136         <switch name="items">
1137             <fieldref>format</fieldref>
1138             <!-- <bitcase> is not correct, this would need <cases>s.
1139                  It works in that case, because PropertyFormat items can be
1140                  distinguished exactly as their values don't have equal bits.
1141             -->
1142             <bitcase>
1143                 <enumref ref="PropertyFormat">8Bits</enumref>
1144                 <list type="CARD8" name="data8">
1145                     <fieldref>num_items</fieldref>
1146                 </list>
1147                 <pad align="4" />
1148             </bitcase>
1149             <bitcase>
1150                 <enumref ref="PropertyFormat">16Bits</enumref>
1151                 <list type="CARD16" name="data16">
1152                     <fieldref>num_items</fieldref>
1153                 </list>
1154                 <pad align="4" />
1155             </bitcase>
1156             <bitcase>
1157                 <enumref ref="PropertyFormat">32Bits</enumref>
1158                 <list type="CARD32" name="data32">
1159                     <fieldref>num_items</fieldref>
1160                 </list>
1161             </bitcase>
1162         </switch>
1163     </request>
1164
1165     <!-- DeleteDeviceProperty -->
1166
1167     <request name="DeleteDeviceProperty" opcode="38">
1168         <field type="ATOM"  name="property" />
1169         <field type="CARD8" name="device_id" />
1170         <pad bytes="3" />
1171     </request>
1172
1173     <!-- GetDeviceProperty -->
1174
1175     <request name="GetDeviceProperty" opcode="39">
1176         <field type="ATOM"   name="property" />
1177         <field type="ATOM"   name="type" />
1178         <field type="CARD32" name="offset" />
1179         <field type="CARD32" name="len" />
1180         <field type="CARD8"  name="device_id" />
1181         <field type="BOOL"   name="delete" />
1182         <pad bytes="2" />
1183         <reply>
1184             <field type="CARD8"  name="xi_reply_type" />
1185             <field type="ATOM"   name="type" />
1186             <field type="CARD32" name="bytes_after" />
1187             <field type="CARD32" name="num_items" />
1188             <field type="CARD8"  name="format" enum="PropertyFormat" />
1189             <field type="CARD8"  name="device_id" />
1190             <pad bytes="10" />
1191             <switch name="items">
1192                 <fieldref>format</fieldref>
1193                 <!-- <bitcase> is not correct, this would need <cases>s.
1194                      It works in that case, because PropertyFormat items can be
1195                      distinguished exactly as their values don't have equal bits.
1196                 -->
1197                 <bitcase>
1198                     <enumref ref="PropertyFormat">8Bits</enumref>
1199                     <list type="CARD8" name="data8">
1200                         <fieldref>num_items</fieldref>
1201                     </list>
1202                     <pad align="4" />
1203                 </bitcase>
1204                 <bitcase>
1205                     <enumref ref="PropertyFormat">16Bits</enumref>
1206                     <list type="CARD16" name="data16">
1207                         <fieldref>num_items</fieldref>
1208                     </list>
1209                     <pad align="4" />
1210                 </bitcase>
1211                 <bitcase>
1212                     <enumref ref="PropertyFormat">32Bits</enumref>
1213                     <list type="CARD32" name="data32">
1214                         <fieldref>num_items</fieldref>
1215                     </list>
1216                 </bitcase>
1217             </switch>
1218         </reply>
1219     </request>
1220
1221     <!-- ⋅⋅⋅ Requests (v2.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1222
1223     <!-- XIQueryPointer -->
1224
1225     <enum name="Device">
1226         <item name="All">       <value>0</value> </item>
1227         <item name="AllMaster"> <value>1</value> </item>
1228     </enum>
1229
1230     <struct name="GroupInfo">
1231         <field type="CARD8" name="base" />
1232         <field type="CARD8" name="latched" />
1233         <field type="CARD8" name="locked" />
1234         <field type="CARD8" name="effective" />
1235     </struct>
1236
1237     <struct name="ModifierInfo">
1238         <field type="CARD32" name="base" />
1239         <field type="CARD32" name="latched" />
1240         <field type="CARD32" name="locked" />
1241         <field type="CARD32" name="effective" />
1242     </struct>
1243
1244     <request name="XIQueryPointer" opcode="40">
1245         <field type="WINDOW"   name="window" />
1246         <field type="DeviceId" name="deviceid" altenum="Device" />
1247         <pad bytes="2" />
1248         <reply>
1249             <pad bytes="1" />
1250             <field type="WINDOW"       name="root" />
1251             <field type="WINDOW"       name="child" />
1252             <field type="FP1616"       name="root_x" />
1253             <field type="FP1616"       name="root_y" />
1254             <field type="FP1616"       name="win_x" />
1255             <field type="FP1616"       name="win_y" />
1256             <field type="BOOL"         name="same_screen" />
1257             <pad bytes="1" />
1258             <field type="CARD16"       name="buttons_len" />
1259             <field type="ModifierInfo" name="mods" />
1260             <field type="GroupInfo"    name="group" />
1261             <list type="CARD32" name="buttons">
1262                 <fieldref>buttons_len</fieldref>
1263             </list>
1264         </reply>
1265     </request>
1266
1267     <!-- XIWarpPointer -->
1268
1269     <request name="XIWarpPointer" opcode="41">
1270         <field type="WINDOW"   name="src_win" />
1271         <field type="WINDOW"   name="dst_win" />
1272         <field type="FP1616"   name="src_x" />
1273         <field type="FP1616"   name="src_y" />
1274         <field type="CARD16"   name="src_width" />
1275         <field type="CARD16"   name="src_height" />
1276         <field type="FP1616"   name="dst_x" />
1277         <field type="FP1616"   name="dst_y" />
1278         <field type="DeviceId" name="deviceid" altenum="Device" />
1279         <pad bytes="2" />
1280     </request>
1281
1282     <!-- XIChangeCursor -->
1283
1284     <request name="XIChangeCursor" opcode="42">
1285         <field type="WINDOW"   name="window" />
1286         <field type="CURSOR"   name="cursor" />
1287         <field type="DeviceId" name="deviceid" altenum="Device" />
1288         <pad bytes="2" />
1289     </request>
1290
1291     <!-- XIChangeHierarchy -->
1292
1293     <enum name="HierarchyChangeType">
1294         <item name="AddMaster">    <value>1</value> </item>
1295         <item name="RemoveMaster"> <value>2</value> </item>
1296         <item name="AttachSlave">  <value>3</value> </item>
1297         <item name="DetachSlave">  <value>4</value> </item>
1298     </enum>
1299
1300     <enum name="ChangeMode">
1301         <item name="Attach"> <value>1</value> </item>
1302         <item name="Float">  <value>2</value> </item>
1303     </enum>
1304
1305     <struct name="AddMaster">
1306         <field type="CARD16" name="type" enum="HierarchyChangeType" />
1307         <field type="CARD16" name="len" />
1308         <field type="CARD16" name="name_len" />
1309         <field type="BOOL"   name="send_core" />
1310         <field type="BOOL"   name="enable" />
1311         <list type="char" name="name">
1312             <fieldref>name_len</fieldref>
1313         </list>
1314         <pad align="4" />
1315     </struct>
1316
1317     <struct name="RemoveMaster">
1318         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1319         <field type="CARD16"   name="len" />
1320         <field type="DeviceId" name="deviceid" altenum="Device" />
1321         <field type="CARD8"    name="return_mode" enum="ChangeMode" />
1322         <pad bytes="1" />
1323         <field type="DeviceId" name="return_pointer" altenum="Device" />
1324         <field type="DeviceId" name="return_keyboard" altenum="Device" />
1325     </struct>
1326
1327     <struct name="AttachSlave">
1328         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1329         <field type="CARD16"   name="len" />
1330         <field type="DeviceId" name="deviceid" altenum="Device" />
1331         <field type="DeviceId" name="master" altenum="Device" />
1332     </struct>
1333
1334     <struct name="DetachSlave">
1335         <field type="CARD16"   name="type" enum="HierarchyChangeType" />
1336         <field type="CARD16"   name="len" />
1337         <field type="DeviceId" name="deviceid" altenum="Device" />
1338         <pad bytes="2" />
1339     </struct>
1340
1341     <struct name="HierarchyChange">
1342         <field type="CARD16" name="type" enum="HierarchyChangeType" />
1343         <field type="CARD16" name="len" />
1344         <list type="CARD8" name="uninterpreted_data">
1345             <op op="-">
1346                 <op op="*">
1347                     <fieldref>len</fieldref>
1348                     <value>4</value>
1349                 </op>
1350                 <value>4</value>
1351             </op>
1352         </list>
1353     </struct>
1354
1355     <request name="XIChangeHierarchy" opcode="43">
1356         <field type="CARD8" name="num_changes" />
1357         <pad bytes="3" />
1358         <list type="HierarchyChange" name="changes">
1359             <fieldref>num_changes</fieldref>
1360         </list>
1361     </request>
1362
1363     <!-- XISetClientPointer -->
1364
1365     <request name="XISetClientPointer" opcode="44">
1366         <field type="WINDOW"   name="window" />
1367         <field type="DeviceId" name="deviceid" altenum="Device" />
1368         <pad bytes="2" />
1369     </request>
1370
1371     <!-- XIGetClientPointer -->
1372
1373     <request name="XIGetClientPointer" opcode="45">
1374         <field type="WINDOW" name="window" />
1375         <reply>
1376             <pad bytes="1" />
1377             <field type="BOOL"     name="set" />
1378             <pad bytes="1" />
1379             <field type="DeviceId" name="deviceid" altenum="Device" />
1380             <pad bytes="20" />
1381         </reply>
1382     </request>
1383
1384     <!-- XISelectEvents -->
1385
1386     <enum name="XIEventMask">
1387         <item name="DeviceChanged">    <bit>1</bit> </item>
1388         <item name="KeyPress">         <bit>2</bit> </item>
1389         <item name="KeyRelease">       <bit>3</bit> </item>
1390         <item name="ButtonPress">      <bit>4</bit> </item>
1391         <item name="ButtonRelease">    <bit>5</bit> </item>
1392         <item name="Motion">           <bit>6</bit> </item>
1393         <item name="Enter">            <bit>7</bit> </item>
1394         <item name="Leave">            <bit>8</bit> </item>
1395         <item name="FocusIn">          <bit>9</bit> </item>
1396         <item name="FocusOut">         <bit>10</bit> </item>
1397         <item name="Hierarchy">        <bit>11</bit> </item>
1398         <item name="Property">         <bit>12</bit> </item>
1399         <!-- ⋅⋅⋅ Events (v2.1) ⋅⋅⋅ -->
1400         <item name="RawKeyPress">      <bit>13</bit> </item>
1401         <item name="RawKeyRelease">    <bit>14</bit> </item>
1402         <item name="RawButtonPress">   <bit>15</bit> </item>
1403         <item name="RawButtonRelease"> <bit>16</bit> </item>
1404         <item name="RawMotion">        <bit>17</bit> </item>
1405         <!-- ⋅⋅⋅ Events (v2.2) ⋅⋅⋅ -->
1406         <item name="TouchBegin">       <bit>18</bit> </item>
1407         <item name="TouchUpdate">      <bit>19</bit> </item>
1408         <item name="TouchEnd">         <bit>20</bit> </item>
1409         <item name="TouchOwnership">   <bit>21</bit> </item>
1410         <item name="RawTouchBegin">    <bit>22</bit> </item>
1411         <item name="RawTouchUpdate">   <bit>23</bit> </item>
1412         <item name="RawTouchEnd">      <bit>24</bit> </item>
1413         <!-- ⋅⋅⋅ Events (v2.3) ⋅⋅⋅ -->
1414         <item name="BarrierHit">       <bit>25</bit> </item>
1415         <item name="BarrierLeave">     <bit>26</bit> </item>
1416     </enum>
1417
1418     <struct name="EventMask">
1419         <field type="DeviceId" name="deviceid" altenum="Device" />
1420         <field type="CARD16"   name="mask_len" />
1421         <list type="CARD32" name="mask" mask="XIEventMask">
1422             <fieldref>mask_len</fieldref>
1423         </list>
1424     </struct>
1425
1426     <request name="XISelectEvents" opcode="46">
1427         <field type="WINDOW" name="window" />
1428         <field type="CARD16" name="num_mask" />
1429         <pad bytes="2" />
1430         <list type="EventMask" name="masks">
1431             <fieldref>num_mask</fieldref>
1432         </list>
1433     </request>
1434
1435     <!-- XIQueryVersion -->
1436
1437     <request name="XIQueryVersion" opcode="47">
1438         <field type="CARD16" name="major_version" />
1439         <field type="CARD16" name="minor_version" />
1440
1441         <reply>
1442             <pad bytes="1" />
1443             <field type="CARD16" name="major_version" />
1444             <field type="CARD16" name="minor_version" />
1445             <pad bytes="20" />
1446         </reply>
1447     </request>
1448
1449     <!-- XIQueryDevice -->
1450
1451     <enum name="DeviceClassType">
1452         <item name="Key">      <value>0</value> </item>
1453         <item name="Button">   <value>1</value> </item>
1454         <item name="Valuator"> <value>2</value> </item>
1455         <item name="Scroll">   <value>3</value> </item>
1456         <item name="Touch">    <value>8</value> </item>
1457     </enum>
1458
1459     <enum name="DeviceType">
1460         <item name="MasterPointer">  <value>1</value> </item>
1461         <item name="MasterKeyboard"> <value>2</value> </item>
1462         <item name="SlavePointer">   <value>3</value> </item>
1463         <item name="SlaveKeyboard">  <value>4</value> </item>
1464         <item name="FloatingSlave">  <value>5</value> </item>
1465     </enum>
1466
1467     <enum name="ScrollFlags">
1468         <item name="NoEmulation"> <bit>0</bit> </item>
1469         <item name="Preferred">   <bit>1</bit> </item>
1470     </enum>
1471
1472     <enum name="ScrollType">
1473         <item name="Vertical">   <value>1</value> </item>
1474         <item name="Horizontal"> <value>2</value> </item>
1475     </enum>
1476
1477     <enum name="TouchMode">
1478         <item name="Direct">    <value>1</value> </item>
1479         <item name="Dependent"> <value>2</value> </item>
1480     </enum>
1481
1482     <struct name="ButtonClass">
1483         <field type="CARD16"   name="type" enum="DeviceClassType" />
1484         <field type="CARD16"   name="len" />
1485         <field type="DeviceId" name="sourceid" />
1486         <field type="CARD16"   name="num_buttons" />
1487         <list type="CARD32"    name="state">
1488             <op op="/">
1489                 <op op="+">
1490                     <fieldref>num_buttons</fieldref>
1491                     <value>31</value>
1492                 </op>
1493                 <value>32</value>
1494             </op>
1495         </list>
1496         <list type="ATOM" name="labels">
1497             <fieldref>num_buttons</fieldref>
1498         </list>
1499     </struct>
1500
1501     <struct name="KeyClass">
1502         <field type="CARD16"   name="type" enum="DeviceClassType" />
1503         <field type="CARD16"   name="len" />
1504         <field type="DeviceId" name="sourceid" />
1505         <field type="CARD16"   name="num_keys" />
1506         <list type="CARD32" name="keys">
1507             <fieldref>num_keys</fieldref>
1508         </list>
1509     </struct>
1510
1511     <struct name="ScrollClass">
1512         <field type="CARD16"   name="type" enum="DeviceClassType" />
1513         <field type="CARD16"   name="len" />
1514         <field type="DeviceId" name="sourceid" />
1515         <field type="CARD16"   name="number" />
1516         <field type="CARD16"   name="scroll_type" enum="ScrollType" />
1517         <pad bytes="2" />
1518         <field type="CARD32"   name="flags" mask="ScrollFlags" />
1519         <field type="FP3232"   name="increment" />
1520     </struct>
1521
1522     <struct name="TouchClass">
1523         <field type="CARD16"   name="type" enum="DeviceClassType" />
1524         <field type="CARD16"   name="len" />
1525         <field type="DeviceId" name="sourceid" />
1526         <field type="CARD8"    name="mode" enum="TouchMode" />
1527         <field type="CARD8"    name="num_touches" />
1528     </struct>
1529
1530     <struct name="ValuatorClass">
1531         <field type="CARD16"   name="type" enum="DeviceClassType" />
1532         <field type="CARD16"   name="len" />
1533         <field type="DeviceId" name="sourceid" />
1534         <field type="CARD16"   name="number" />
1535         <field type="ATOM"     name="label" />
1536         <field type="FP3232"   name="min" />
1537         <field type="FP3232"   name="max" />
1538         <field type="FP3232"   name="value" />
1539         <field type="CARD32"   name="resolution" />
1540         <field type="CARD8"    name="mode" enum="ValuatorMode" />
1541         <pad bytes="3" />
1542     </struct>
1543
1544     <struct name="DeviceClass">
1545         <field type="CARD16"   name="type" enum="DeviceClassType" />
1546         <field type="CARD16"   name="len" />
1547         <field type="DeviceId" name="sourceid" />
1548         <pad bytes="2" />
1549         <list type="CARD8" name="uninterpreted_data">
1550             <op op="-">
1551                 <op op="*">
1552                     <fieldref>len</fieldref>
1553                     <value>4</value>
1554                 </op>
1555                 <value>8</value>
1556             </op>
1557         </list>
1558     </struct>
1559
1560     <struct name="XIDeviceInfo">
1561         <field type="DeviceId" name="deviceid" altenum="Device" />
1562         <field type="CARD16"   name="type" enum="DeviceType" />
1563         <field type="DeviceId" name="attachment" altenum="Device" />
1564         <field type="CARD16"   name="num_classes" />
1565         <field type="CARD16"   name="name_len" />
1566         <field type="BOOL"     name="enabled" />
1567         <pad bytes="1" />
1568         <list type="char" name="name">
1569             <fieldref>name_len</fieldref>
1570         </list>
1571         <pad align="4" />
1572         <list type="DeviceClass" name="classes">
1573             <fieldref>num_classes</fieldref>
1574         </list>
1575     </struct>
1576
1577     <request name="XIQueryDevice" opcode="48">
1578         <field type="DeviceId" name="deviceid" altenum="Device" />
1579         <pad bytes="2" />
1580         <reply>
1581             <pad bytes="1" />
1582             <field type="CARD16" name="num_infos" />
1583             <pad bytes="22" />
1584             <list type="XIDeviceInfo" name="infos">
1585                 <fieldref>num_infos</fieldref>
1586             </list>
1587         </reply>
1588     </request>
1589
1590     <!-- XISetFocus -->
1591
1592     <request name="XISetFocus" opcode="49">
1593         <field type="WINDOW"    name="window" />
1594         <field type="TIMESTAMP" name="time" altenum="Time" />
1595         <field type="DeviceId"  name="deviceid" altenum="Device" />
1596         <pad bytes="2" />
1597     </request>
1598
1599     <!-- XIGetFocus -->
1600
1601     <request name="XIGetFocus" opcode="50">
1602         <field type="DeviceId" name="deviceid" altenum="Device" />
1603         <pad bytes="2" />
1604         <reply>
1605             <pad bytes="1" />
1606             <field type="WINDOW" name="focus" />
1607             <pad bytes="20" />
1608         </reply>
1609     </request>
1610
1611     <!-- XIGrabDevice -->
1612
1613     <enum name="GrabOwner">
1614         <item name="NoOwner"> <value>0</value> </item>
1615         <item name="Owner">   <value>1</value> </item>
1616     </enum>
1617
1618     <request name="XIGrabDevice" opcode="51">
1619         <field type="WINDOW"    name="window" />
1620         <field type="TIMESTAMP" name="time" altenum="Time" />
1621         <field type="CURSOR"    name="cursor" />
1622         <field type="DeviceId"  name="deviceid" altenum="Device" />
1623         <field type="CARD8"     name="mode" enum="GrabMode" />
1624         <field type="CARD8"     name="paired_device_mode" enum="GrabMode" />
1625         <field type="BOOL"      name="owner_events" enum="GrabOwner" />
1626         <pad bytes="1" />
1627         <field type="CARD16"    name="mask_len" />
1628         <list type="CARD32" name="mask">
1629             <fieldref>mask_len</fieldref>
1630         </list>
1631         <reply>
1632             <pad bytes="1" />
1633             <field type="CARD8" name="status" enum="GrabStatus" />
1634             <pad bytes="23" />
1635         </reply>
1636     </request>
1637
1638     <!-- XIUngrabDevice -->
1639
1640     <request name="XIUngrabDevice" opcode="52">
1641         <field type="TIMESTAMP" name="time" altenum="Time" />
1642         <field type="DeviceId" name="deviceid" altenum="Device" />
1643         <pad bytes="2" />
1644     </request>
1645
1646     <!-- XIAllowEvents -->
1647
1648     <enum name="EventMode">
1649         <item name="AsyncDevice">       <value>0</value> </item>
1650         <item name="SyncDevice">        <value>1</value> </item>
1651         <item name="ReplayDevice">      <value>2</value> </item>
1652         <item name="AsyncPairedDevice"> <value>3</value> </item>
1653         <item name="AsyncPair">         <value>4</value> </item>
1654         <item name="SyncPair">          <value>5</value> </item>
1655         <item name="AcceptTouch">       <value>6</value> </item>
1656         <item name="RejectTouch">       <value>7</value> </item>
1657     </enum>
1658
1659     <request name="XIAllowEvents" opcode="53">
1660         <field type="TIMESTAMP" name="time" altenum="Time" />
1661         <field type="DeviceId"  name="deviceid" altenum="Device" />
1662         <field type="CARD8"     name="event_mode" enum="EventMode" />
1663         <pad bytes="1" />
1664         <field type="CARD32"    name="touchid" />
1665         <field type="WINDOW"    name="grab_window" />
1666     </request>
1667
1668     <!-- XIPassiveGrabDevice -->
1669
1670     <enum name="GrabMode22">
1671         <item name="Sync">  <value>0</value> </item>
1672         <item name="Async"> <value>1</value> </item>
1673         <item name="Touch"> <value>2</value> </item>
1674     </enum>
1675
1676     <enum name="GrabType">
1677         <item name="Button">     <value>0</value> </item>
1678         <item name="Keycode">    <value>1</value> </item>
1679         <item name="Enter">      <value>2</value> </item>
1680         <item name="FocusIn">    <value>3</value> </item>
1681         <item name="TouchBegin"> <value>4</value> </item>
1682     </enum>
1683
1684     <enum name="ModifierMask">
1685         <item name="Any"> <bit>31</bit> </item>
1686     </enum>
1687
1688     <struct name="GrabModifierInfo">
1689         <field type="CARD32" name="modifiers" altenum="ModifierMask" />
1690         <field type="CARD8"  name="status" enum="GrabStatus" />
1691         <pad bytes="3" />
1692     </struct>
1693
1694     <request name="XIPassiveGrabDevice" opcode="54">
1695         <!-- field "time" is unused and its value is undefined -->
1696         <field type="TIMESTAMP" name="time" altenum="Time" />
1697         <field type="WINDOW"    name="grab_window" />
1698         <field type="CURSOR"    name="cursor" />
1699         <field type="CARD32"    name="detail" />
1700         <field type="DeviceId"  name="deviceid" altenum="Device" />
1701         <field type="CARD16"    name="num_modifiers" />
1702         <field type="CARD16"    name="mask_len" />
1703         <field type="CARD8"     name="grab_type" enum="GrabType" />
1704         <field type="CARD8"     name="grab_mode" enum="GrabMode22" />
1705         <field type="CARD8"     name="paired_device_mode" enum="GrabMode" />
1706         <field type="BOOL"      name="owner_events" enum="GrabOwner" />
1707         <pad bytes="2" />
1708         <list type="CARD32" name="mask">
1709             <fieldref>mask_len</fieldref>
1710         </list>
1711         <list type="CARD32" name="modifiers">
1712             <fieldref>num_modifiers</fieldref>
1713         </list>
1714         <reply>
1715             <pad bytes="1" />
1716             <field type="CARD16" name="num_modifiers" />
1717             <pad bytes="22" />
1718             <list type="GrabModifierInfo" name="modifiers">
1719                 <fieldref>num_modifiers</fieldref>
1720             </list>
1721         </reply>
1722     </request>
1723
1724     <!-- XIPassiveUngrabDevice -->
1725
1726     <request name="XIPassiveUngrabDevice" opcode="55">
1727         <field type="WINDOW"   name="grab_window" />
1728         <field type="CARD32"   name="detail" />
1729         <field type="DeviceId" name="deviceid" altenum="Device" />
1730         <field type="CARD16"   name="num_modifiers" />
1731         <field type="CARD8"    name="grab_type" enum="GrabType" />
1732         <pad bytes="3" />
1733         <list type="CARD32" name="modifiers">
1734             <fieldref>num_modifiers</fieldref>
1735         </list>
1736     </request>
1737
1738     <!-- XIListProperties -->
1739
1740     <request name="XIListProperties" opcode="56">
1741         <field type="DeviceId" name="deviceid" altenum="Device" />
1742         <pad bytes="2" />
1743         <reply>
1744             <pad bytes="1" />
1745             <field type="CARD16" name="num_properties" />
1746             <pad bytes="22" />
1747             <list type="ATOM" name="properties">
1748                 <fieldref>num_properties</fieldref>
1749             </list>
1750         </reply>
1751     </request>
1752
1753     <!-- XIChangeProperty -->
1754
1755     <request name="XIChangeProperty" opcode="57">
1756         <field type="DeviceId" name="deviceid" altenum="Device" />
1757         <field type="CARD8"    name="mode" enum="PropMode" />
1758         <field type="CARD8"    name="format" enum="PropertyFormat" />
1759         <field type="ATOM"     name="property" />
1760         <field type="ATOM"     name="type" />
1761         <field type="CARD32"   name="num_items" />
1762         <switch name="items">
1763             <fieldref>format</fieldref>
1764             <!-- <bitcase> is not correct, this would need <cases>s.
1765                  It works in that case, because PropertyFormat items can be
1766                  distinguished exactly as their values don't have equal bits.
1767             -->
1768             <bitcase>
1769                 <enumref ref="PropertyFormat">8Bits</enumref>
1770                 <list type="CARD8" name="data8">
1771                     <fieldref>num_items</fieldref>
1772                 </list>
1773             </bitcase>
1774             <bitcase>
1775                 <enumref ref="PropertyFormat">16Bits</enumref>
1776                 <list type="CARD16" name="data16">
1777                     <fieldref>num_items</fieldref>
1778                 </list>
1779             </bitcase>
1780             <bitcase>
1781                 <enumref ref="PropertyFormat">32Bits</enumref>
1782                 <list type="CARD32" name="data32">
1783                     <fieldref>num_items</fieldref>
1784                 </list>
1785             </bitcase>
1786         </switch>
1787     </request>
1788
1789     <!-- XIDeleteProperty -->
1790
1791     <request name="XIDeleteProperty" opcode="58">
1792         <field type="DeviceId" name="deviceid" altenum="Device" />
1793         <pad bytes="2" />
1794         <field type="ATOM"     name="property" />
1795     </request>
1796
1797     <!-- XIGetProperty -->
1798
1799     <request name="XIGetProperty" opcode="59">
1800         <field type="DeviceId" name="deviceid" altenum="Device" />
1801         <field type="BOOL"     name="delete" />
1802         <pad bytes="1" />
1803         <field type="ATOM"     name="property" />
1804         <field type="ATOM"     name="type" />
1805         <field type="CARD32"   name="offset" />
1806         <field type="CARD32"   name="len" />
1807         <reply>
1808             <pad bytes="1" />
1809             <field type="ATOM"   name="type" />
1810             <field type="CARD32" name="bytes_after" />
1811             <field type="CARD32" name="num_items" />
1812             <field type="CARD8"  name="format" enum="PropertyFormat" />
1813             <pad bytes="11" />
1814             <switch name="items">
1815                 <fieldref>format</fieldref>
1816                 <!-- <bitcase> is not correct, this would need <cases>s.
1817                      It works in that case, because PropertyFormat items can be
1818                      distinguished exactly as their values don't have equal bits.
1819                 -->
1820                 <bitcase>
1821                     <enumref ref="PropertyFormat">8Bits</enumref>
1822                     <list type="CARD8" name="data8">
1823                         <fieldref>num_items</fieldref>
1824                     </list>
1825                     <pad align="4" />
1826                 </bitcase>
1827                 <bitcase>
1828                     <enumref ref="PropertyFormat">16Bits</enumref>
1829                     <list type="CARD16" name="data16">
1830                         <fieldref>num_items</fieldref>
1831                     </list>
1832                     <pad align="4" />
1833                 </bitcase>
1834                 <bitcase>
1835                     <enumref ref="PropertyFormat">32Bits</enumref>
1836                     <list type="CARD32" name="data32">
1837                         <fieldref>num_items</fieldref>
1838                     </list>
1839                 </bitcase>
1840             </switch>
1841         </reply>
1842     </request>
1843
1844     <!-- XIGetSelectedEvents -->
1845
1846     <request name="XIGetSelectedEvents" opcode="60">
1847         <field type="WINDOW" name="window" />
1848         <reply>
1849             <pad bytes="1" />
1850             <field type="CARD16" name="num_masks" />
1851             <pad bytes="22" />
1852             <list type="EventMask" name="masks">
1853                 <fieldref>num_masks</fieldref>
1854             </list>
1855         </reply>
1856     </request>
1857
1858     <!-- ⋅⋅⋅ Requests (v2.3) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1859
1860     <!-- XIBarrierReleasePointer -->
1861
1862     <struct name="BarrierReleasePointerInfo">
1863         <field type="DeviceId" name="deviceid" />
1864         <pad bytes="2" />
1865         <field type="BARRIER"  name="barrier" />
1866         <field type="CARD32"   name="eventid" />
1867     </struct>
1868
1869     <request name="XIBarrierReleasePointer" opcode="61">
1870         <field type="CARD32" name="num_barriers" />
1871         <list type="BarrierReleasePointerInfo" name="barriers">
1872             <fieldref>num_barriers</fieldref>
1873         </list>
1874     </request>
1875
1876     <!-- ⋅⋅⋅ Events (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1877     <!-- Notes:
1878          - A 'len' field in a v1++ structure is in bytes.
1879     -->
1880
1881     <event name="DeviceValuator" number="0">
1882         <field type="CARD8"  name="device_id" />
1883         <field type="CARD16" name="device_state" />
1884         <field type="CARD8"  name="num_valuators" />
1885         <field type="CARD8"  name="first_valuator" />
1886         <list type="INT32"   name="valuators">
1887             <value>6</value>
1888         </list>
1889     </event>
1890
1891     <!-- the highest bit in a CARD8 device_id-field indicates that more
1892         events will follow -->
1893     <enum name="MoreEventsMask">
1894         <item name="MoreEvents"> <bit>7</bit> </item> <!-- 0x80 -->
1895     </enum>
1896
1897     <event name="DeviceKeyPress" number="1">
1898         <field type="BYTE"      name="detail" />
1899         <field type="TIMESTAMP" name="time" />
1900         <field type="WINDOW"    name="root" />
1901         <field type="WINDOW"    name="event" />
1902         <field type="WINDOW"    name="child" altenum="Window" />
1903         <field type="INT16"     name="root_x" />
1904         <field type="INT16"     name="root_y" />
1905         <field type="INT16"     name="event_x" />
1906         <field type="INT16"     name="event_y" />
1907         <field type="CARD16"    name="state" mask="KeyButMask" />
1908         <field type="BOOL"      name="same_screen" />
1909         <field type="CARD8"     name="device_id" altmask="MoreEventsMask" />
1910     </event>
1911
1912     <eventcopy name="DeviceKeyRelease"    number="2" ref="DeviceKeyPress" />
1913     <eventcopy name="DeviceButtonPress"   number="3" ref="DeviceKeyPress" />
1914     <eventcopy name="DeviceButtonRelease" number="4" ref="DeviceKeyPress" />
1915     <eventcopy name="DeviceMotionNotify"  number="5" ref="DeviceKeyPress" />
1916
1917     <event name="DeviceFocusIn" number="6">
1918         <field type="BYTE"      name="detail" enum="xproto:NotifyDetail" />
1919         <field type="TIMESTAMP" name="time" />
1920         <field type="WINDOW"    name="window" />
1921         <field type="BYTE"      name="mode" enum="xproto:NotifyMode" />
1922         <field type="CARD8"     name="device_id" />
1923         <pad bytes="18" />
1924     </event>
1925
1926     <eventcopy name="DeviceFocusOut" number="7" ref="DeviceFocusIn" />
1927     <eventcopy name="ProximityIn"    number="8" ref="DeviceKeyPress" />
1928     <eventcopy name="ProximityOut"   number="9" ref="DeviceKeyPress" />
1929
1930     <enum name="ClassesReportedMask">
1931         <item name="OutOfProximity">     <bit>7</bit> </item> <!-- 0x80 -->
1932             <!-- 0 = InProxmity, 1 = OutOfProximity -->
1933
1934         <item name="DeviceModeAbsolute"> <bit>6</bit> </item> <!-- 0x40 -->
1935             <!-- 0 = Relative, 1 = Absolute -->
1936
1937         <item name="ReportingValuators"> <bit>2</bit> </item> <!-- 0x04 -->
1938         <item name="ReportingButtons">   <bit>1</bit> </item> <!-- 0x02 -->
1939         <item name="ReportingKeys">      <bit>0</bit> </item> <!-- 0x01 -->
1940     </enum>
1941
1942     <event name="DeviceStateNotify" number="10">
1943         <field type="BYTE"      name="device_id" altmask="MoreEventsMask" />
1944         <field type="TIMESTAMP" name="time" />
1945         <field type="CARD8"     name="num_keys" />
1946         <field type="CARD8"     name="num_buttons" />
1947         <field type="CARD8"     name="num_valuators" />
1948         <field type="CARD8"     name="classes_reported" mask="ClassesReportedMask" />
1949         <list type="CARD8"      name="buttons">
1950             <value>4</value>
1951         </list>
1952         <list type="CARD8" name="keys">
1953             <value>4</value>
1954         </list>
1955         <list type="CARD32" name="valuators">
1956             <value>3</value>
1957         </list>
1958     </event>
1959
1960     <event name="DeviceMappingNotify" number="11">
1961         <field type="BYTE"    name="device_id" />
1962         <field type="CARD8"   name="request" enum="Mapping" />
1963         <field type="KeyCode" name="first_keycode" />
1964         <field type="CARD8"   name="count" />
1965         <pad bytes="1" />
1966         <field type="TIMESTAMP" name="time" />
1967         <pad bytes="20" />
1968     </event>
1969
1970     <enum name="ChangeDevice">
1971         <item name="NewPointer">  <value>0</value> </item>
1972         <item name="NewKeyboard"> <value>1</value> </item>
1973     </enum>
1974
1975     <event name="ChangeDeviceNotify" number="12">
1976         <field type="BYTE"      name="device_id" />
1977         <field type="TIMESTAMP" name="time" />
1978         <field type="CARD8"     name="request" enum="ChangeDevice" />
1979         <pad bytes="23" />
1980     </event>
1981
1982     <event name="DeviceKeyStateNotify" number="13">
1983         <field type="BYTE" name="device_id" altmask="MoreEventsMask" />
1984         <list type="CARD8" name="keys">
1985             <value>28</value>
1986         </list>
1987     </event>
1988
1989     <event name="DeviceButtonStateNotify" number="14">
1990         <field type="BYTE" name="device_id" altmask="MoreEventsMask" />
1991         <list type="CARD8" name="buttons">
1992             <value>28</value>
1993         </list>
1994     </event>
1995
1996     <!-- ⋅⋅⋅ Events (v1.4) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
1997
1998     <enum name="DeviceChange">
1999         <item name="Added">          <value>0</value> </item>
2000         <item name="Removed">        <value>1</value> </item>
2001         <item name="Enabled">        <value>2</value> </item>
2002         <item name="Disabled">       <value>3</value> </item>
2003         <item name="Unrecoverable">  <value>4</value> </item>
2004         <item name="ControlChanged"> <value>5</value> </item>
2005     </enum>
2006
2007     <event name="DevicePresenceNotify" number="15">
2008         <pad bytes="1" />
2009         <field type="TIMESTAMP" name="time" />
2010         <field type="BYTE"      name="devchange" enum="DeviceChange" />
2011         <field type="BYTE"      name="device_id" />
2012         <field type="CARD16"    name="control" />
2013         <pad bytes="20" />
2014     </event>
2015
2016     <!-- ⋅⋅⋅ Events (v1.5) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2017
2018     <event name="DevicePropertyNotify" number="16">
2019         <field type="BYTE"      name="state" enum="Property" />
2020         <field type="TIMESTAMP" name="time" />
2021         <field type="ATOM"      name="property" />
2022         <pad bytes="19" />
2023         <field type="CARD8"     name="device_id" />
2024     </event>
2025
2026     <!-- ⋅⋅⋅ Events (v2.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2027     <!-- Notes:
2028          - A 'len' field in a v2++ structure is in 4 byte units.
2029     -->
2030
2031     <enum name="ChangeReason">
2032         <item name="SlaveSwitch">  <value>1</value> </item>
2033         <item name="DeviceChange"> <value>2</value> </item>
2034     </enum>
2035
2036     <event name="DeviceChanged" number="1" xge="true">
2037         <field type="DeviceId"  name="deviceid" altenum="Device" />
2038         <field type="TIMESTAMP" name="time" altenum="Time" />
2039         <!-- event specific fields -->
2040         <field type="CARD16"    name="num_classes" />
2041         <field type="DeviceId"  name="sourceid" altenum="Device" />
2042         <field type="CARD8"     name="reason" enum="ChangeReason" />
2043         <pad bytes="11" />
2044         <!-- 32 byte boundary -->
2045         <list type="DeviceClass" name="classes">
2046             <fieldref>num_classes</fieldref>
2047         </list>
2048     </event>
2049
2050     <enum name="KeyEventFlags">
2051         <item name="KeyRepeat"> <bit>16</bit> </item>
2052     </enum>
2053
2054     <event name="KeyPress" number="2" xge="true">
2055         <field type="DeviceId"  name="deviceid" altenum="Device" />
2056         <field type="TIMESTAMP" name="time" altenum="Time" />
2057         <!-- event specific fields -->
2058         <field type="CARD32"    name="detail" />
2059         <field type="WINDOW"    name="root" />
2060         <field type="WINDOW"    name="event" />
2061         <field type="WINDOW"    name="child" />
2062         <!-- 32 byte boundary -->
2063         <field type="FP1616"    name="root_x" />
2064         <field type="FP1616"    name="root_y" />
2065         <field type="FP1616"    name="event_x" />
2066         <field type="FP1616"    name="event_y" />
2067         <field type="CARD16"    name="buttons_len" />
2068         <field type="CARD16"    name="valuators_len" />
2069         <field type="DeviceId"  name="sourceid" altenum="Device" />
2070         <pad bytes="2" />
2071         <field type="CARD32"       name="flags" mask="KeyEventFlags" />
2072         <field type="ModifierInfo" name="mods" />
2073         <field type="GroupInfo"    name="group" />
2074         <list type="CARD32" name="button_mask">
2075             <fieldref>buttons_len</fieldref>
2076         </list>
2077         <list type="CARD32" name="valuator_mask">
2078             <fieldref>valuators_len</fieldref>
2079         </list>
2080         <!-- Uninterpreted: list (axisvalues) of FP3232,
2081                             length is <popcount> on valuator_mask list -->
2082     </event>
2083
2084     <eventcopy name="KeyRelease" number="3" ref="KeyPress" />
2085
2086     <enum name="PointerEventFlags">
2087         <item name="PointerEmulated"> <bit>16</bit> </item>
2088     </enum>
2089
2090     <event name="ButtonPress" number="4" xge="true">
2091         <field type="DeviceId"  name="deviceid" altenum="Device" />
2092         <field type="TIMESTAMP" name="time" altenum="Time" />
2093         <!-- event specific fields -->
2094         <field type="CARD32"    name="detail" />
2095         <field type="WINDOW"    name="root" />
2096         <field type="WINDOW"    name="event" />
2097         <field type="WINDOW"    name="child" />
2098         <!-- 32 byte boundary -->
2099         <field type="FP1616"    name="root_x" />
2100         <field type="FP1616"    name="root_y" />
2101         <field type="FP1616"    name="event_x" />
2102         <field type="FP1616"    name="event_y" />
2103         <field type="CARD16"    name="buttons_len" />
2104         <field type="CARD16"    name="valuators_len" />
2105         <field type="DeviceId"  name="sourceid" altenum="Device" />
2106         <pad bytes="2" />
2107         <field type="CARD32"       name="flags" mask="PointerEventFlags" />
2108         <field type="ModifierInfo" name="mods" />
2109         <field type="GroupInfo"    name="group" />
2110         <list type="CARD32" name="button_mask">
2111             <fieldref>buttons_len</fieldref>
2112         </list>
2113         <list type="CARD32" name="valuator_mask">
2114             <fieldref>valuators_len</fieldref>
2115         </list>
2116         <!-- Uninterpreted: list (axisvalues) of FP3232,
2117                             length is <popcount> on valuator_mask list -->
2118     </event>
2119
2120     <eventcopy name="ButtonRelease" number="5" ref="ButtonPress" />
2121     <eventcopy name="Motion"        number="6" ref="ButtonPress" />
2122
2123     <enum name="NotifyMode">
2124         <item name="Normal">        <value>0</value> </item>
2125         <item name="Grab">          <value>1</value> </item>
2126         <item name="Ungrab">        <value>2</value> </item>
2127         <item name="WhileGrabbed">  <value>3</value> </item>
2128         <item name="PassiveGrab">   <value>4</value> </item>
2129         <item name="PassiveUngrab"> <value>5</value> </item>
2130     </enum>
2131
2132     <enum name="NotifyDetail">
2133         <item name="Ancestor">         <value>0</value> </item>
2134         <item name="Virtual">          <value>1</value> </item>
2135         <item name="Inferior">         <value>2</value> </item>
2136         <item name="Nonlinear">        <value>3</value> </item>
2137         <item name="NonlinearVirtual"> <value>4</value> </item>
2138         <item name="Pointer">          <value>5</value> </item>
2139         <item name="PointerRoot">      <value>6</value> </item>
2140         <item name="None">             <value>7</value> </item>
2141     </enum>
2142
2143     <event name="Enter" number="7" xge="true">
2144         <field type="DeviceId"  name="deviceid" altenum="Device" />
2145         <field type="TIMESTAMP" name="time" altenum="Time" />
2146         <!-- event specific fields -->
2147         <field type="DeviceId"  name="sourceid" altenum="Device" />
2148         <field type="CARD8"     name="mode" enum="xinput:NotifyMode" />
2149         <field type="CARD8"     name="detail" enum="xinput:NotifyDetail" />
2150         <field type="WINDOW"    name="root" />
2151         <field type="WINDOW"    name="event" />
2152         <field type="WINDOW"    name="child" />
2153         <!-- 32 byte boundary -->
2154         <field type="FP1616"       name="root_x" />
2155         <field type="FP1616"       name="root_y" />
2156         <field type="FP1616"       name="event_x" />
2157         <field type="FP1616"       name="event_y" />
2158         <field type="BOOL"         name="same_screen" />
2159         <field type="BOOL"         name="focus" />
2160         <field type="CARD16"       name="buttons_len" />
2161         <field type="ModifierInfo" name="mods" />
2162         <field type="GroupInfo"    name="group" />
2163         <list type="CARD32" name="buttons">
2164             <fieldref>buttons_len</fieldref>
2165         </list>
2166     </event>
2167
2168     <eventcopy name="Leave"    number="8" ref="Enter" />
2169     <eventcopy name="FocusIn"  number="9" ref="Enter" />
2170     <eventcopy name="FocusOut" number="10" ref="Enter" />
2171
2172     <enum name="HierarchyMask">
2173         <item name="MasterAdded">    <bit>0</bit> </item>
2174         <item name="MasterRemoved">  <bit>1</bit> </item>
2175         <item name="SlaveAdded">     <bit>2</bit> </item>
2176         <item name="SlaveRemoved">   <bit>3</bit> </item>
2177         <item name="SlaveAttached">  <bit>4</bit> </item>
2178         <item name="SlaveDetached">  <bit>5</bit> </item>
2179         <item name="DeviceEnabled">  <bit>6</bit> </item>
2180         <item name="DeviceDisabled"> <bit>7</bit> </item>
2181     </enum>
2182
2183     <struct name="HierarchyInfo">
2184         <field type="DeviceId" name="deviceid" altenum="Device" />
2185         <field type="DeviceId" name="attachment" altenum="Device" />
2186         <field type="CARD8"    name="type" enum="DeviceType"/>
2187         <field type="BOOL"     name="enabled" />
2188         <pad bytes="2" />
2189         <field type="CARD32"   name="flags" mask="HierarchyMask" />
2190     </struct>
2191
2192     <event name="Hierarchy" number="11" xge="true">
2193         <field type="DeviceId"  name="deviceid" altenum="Device" />
2194         <field type="TIMESTAMP" name="time" altenum="Time" />
2195         <!-- event specific fields -->
2196         <field type="CARD32"    name="flags" mask="HierarchyMask" />
2197         <field type="CARD16"    name="num_infos" />
2198         <pad bytes="10" />
2199         <!-- 32 byte boundary -->
2200         <list type="HierarchyInfo" name="infos">
2201             <fieldref>num_infos</fieldref>
2202         </list>
2203     </event>
2204
2205     <enum name="PropertyFlag">
2206         <item name="Deleted">  <value>0</value> </item>
2207         <item name="Created">  <value>1</value> </item>
2208         <item name="Modified"> <value>2</value> </item>
2209     </enum>
2210
2211     <event name="Property" number="12" xge="true">
2212         <field type="DeviceId"  name="deviceid" altenum="Device" />
2213         <field type="TIMESTAMP" name="time" altenum="Time" />
2214         <!-- event specific fields -->
2215         <field type="ATOM"      name="property" />
2216         <field type="CARD8"     name="what" enum="PropertyFlag" />
2217         <pad bytes="11" />
2218         <!-- 32 byte boundary -->
2219     </event>
2220
2221     <!-- ⋅⋅⋅ Events (v2.1) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2222
2223     <event name="RawKeyPress" number="13" xge="true">
2224         <field type="DeviceId"  name="deviceid" altenum="Device" />
2225         <field type="TIMESTAMP" name="time" altenum="Time" />
2226         <!-- event specific fields -->
2227         <field type="CARD32"    name="detail" />
2228         <field type="DeviceId"  name="sourceid" />
2229         <field type="CARD16"    name="valuators_len" />
2230         <field type="CARD32"    name="flags" mask="KeyEventFlags"/>
2231         <pad bytes="4" />
2232         <!-- 32 byte boundary -->
2233         <list type="CARD32" name="valuator_mask">
2234             <fieldref>valuators_len</fieldref>
2235         </list>
2236         <!-- Uninterpreted: list (axisvalues) of FP3232,
2237                             length is <popcount> on valuator_mask list -->
2238         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2239                             length is <popcount> on valuator_mask list -->
2240     </event>
2241
2242     <eventcopy name="RawKeyRelease" number="14" ref="RawKeyPress" />
2243
2244     <event name="RawButtonPress" number="15" xge="true">
2245         <field type="DeviceId"  name="deviceid" altenum="Device" />
2246         <field type="TIMESTAMP" name="time" altenum="Time" />
2247         <!-- event specific fields -->
2248         <field type="CARD32"    name="detail" />
2249         <field type="DeviceId"  name="sourceid" />
2250         <field type="CARD16"    name="valuators_len" />
2251         <field type="CARD32"    name="flags" mask="PointerEventFlags"/>
2252         <pad bytes="4" />
2253         <!-- 32 byte boundary -->
2254         <list type="CARD32" name="valuator_mask">
2255             <fieldref>valuators_len</fieldref>
2256         </list>
2257         <!-- Uninterpreted: list (axisvalues) of FP3232,
2258                             length is <popcount> on valuator_mask list -->
2259         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2260                             length is <popcount> on valuator_mask list -->
2261     </event>
2262
2263     <eventcopy name="RawButtonRelease" number="16" ref="RawButtonPress" />
2264     <eventcopy name="RawMotion"        number="17" ref="RawButtonPress" />
2265
2266     <!-- ⋅⋅⋅ Events (v2.2) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2267
2268     <enum name="TouchEventFlags">
2269         <item name="TouchPendingEnd">       <bit>16</bit> </item>
2270         <item name="TouchEmulatingPointer"> <bit>17</bit> </item>
2271     </enum>
2272
2273     <event name="TouchBegin" number="18" xge="true">
2274         <field type="DeviceId"  name="deviceid" altenum="Device" />
2275         <field type="TIMESTAMP" name="time" altenum="Time" />
2276         <!-- event specific fields -->
2277         <field type="CARD32"    name="detail" />
2278         <field type="WINDOW"    name="root" />
2279         <field type="WINDOW"    name="event" />
2280         <field type="WINDOW"    name="child" />
2281         <!-- 32 byte boundary -->
2282         <field type="FP1616"    name="root_x" />
2283         <field type="FP1616"    name="root_y" />
2284         <field type="FP1616"    name="event_x" />
2285         <field type="FP1616"    name="event_y" />
2286         <field type="CARD16"    name="buttons_len" />
2287         <field type="CARD16"    name="valuators_len" />
2288         <field type="DeviceId"  name="sourceid" altenum="Device" />
2289         <pad bytes="2" />
2290         <field type="CARD32"       name="flags" mask="TouchEventFlags" />
2291         <field type="ModifierInfo" name="mods" />
2292         <field type="GroupInfo"    name="group" />
2293         <list type="CARD32" name="button_mask">
2294             <fieldref>buttons_len</fieldref>
2295         </list>
2296         <list type="CARD32" name="valuator_mask">
2297             <fieldref>valuators_len</fieldref>
2298         </list>
2299         <!-- Uninterpreted: list (axisvalues) of FP3232,
2300                             length is <popcount> on valuator_mask list -->
2301     </event>
2302
2303     <eventcopy name="TouchUpdate" number="19" ref="TouchBegin" />
2304     <eventcopy name="TouchEnd"    number="20" ref="TouchBegin" />
2305
2306     <enum name="TouchOwnershipFlags">
2307         <!-- XXX: Remove this enum? Currently, no flag is defined. -->
2308         <item name="None"> <value>0</value> </item>
2309     </enum>
2310
2311     <event name="TouchOwnership" number="21" xge="true">
2312         <field type="DeviceId"  name="deviceid" altenum="Device" />
2313         <field type="TIMESTAMP" name="time" altenum="Time" />
2314         <!-- event specific fields -->
2315         <field type="CARD32"    name="touchid" />
2316         <field type="WINDOW"    name="root" />
2317         <field type="WINDOW"    name="event" />
2318         <field type="WINDOW"    name="child" />
2319         <!-- 32 byte boundary -->
2320         <field type="DeviceId"  name="sourceid" altenum="Device" />
2321         <pad bytes="2" />
2322         <field type="CARD32"    name="flags" enum="TouchOwnershipFlags" />
2323         <pad bytes="8" />
2324     </event>
2325
2326     <event name="RawTouchBegin" number="22" 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="detail" />
2331         <field type="DeviceId"  name="sourceid" />
2332         <field type="CARD16"    name="valuators_len" />
2333         <field type="CARD32"    name="flags" mask="TouchEventFlags"/>
2334         <pad bytes="4" />
2335         <!-- 32 byte boundary -->
2336         <list type="CARD32" name="valuator_mask">
2337             <fieldref>valuators_len</fieldref>
2338         </list>
2339         <!-- Uninterpreted: list (axisvalues) of FP3232,
2340                             length is <popcount> on valuator_mask list -->
2341         <!-- Uninterpreted: list (axisvalues_raw) of FP3232,
2342                             length is <popcount> on valuator_mask list -->
2343     </event>
2344
2345     <eventcopy name="RawTouchUpdate" number="23" ref="RawTouchBegin" />
2346     <eventcopy name="RawTouchEnd"    number="24" ref="RawTouchBegin" />
2347
2348     <!-- ⋅⋅⋅ Events (v2.3) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2349
2350     <enum name="BarrierFlags">
2351         <item name="PointerReleased"> <bit>0</bit> </item>
2352         <item name="DeviceIsGrabbed"> <bit>1</bit> </item>
2353     </enum>
2354
2355     <event name="BarrierHit" number="25" xge="true">
2356         <field type="DeviceId"  name="deviceid" altenum="Device" />
2357         <field type="TIMESTAMP" name="time" altenum="Time" />
2358         <!-- event specific fields -->
2359         <field type="CARD32"    name="eventid" />
2360         <field type="WINDOW"    name="root" />
2361         <field type="WINDOW"    name="event" />
2362         <field type="BARRIER"   name="barrier" />
2363         <!-- 32 byte boundary -->
2364         <field type="CARD32"    name="dtime" />
2365         <field type="CARD32"    name="flags" mask="BarrierFlags" />
2366         <field type="DeviceId"  name="sourceid" altenum="Device" />
2367         <pad bytes="2" />
2368         <field type="FP1616"    name="root_x" />
2369         <field type="FP1616"    name="root_y" />
2370         <field type="FP3232"    name="dx" />
2371         <field type="FP3232"    name="dy" />
2372     </event>
2373
2374     <eventcopy name="BarrierLeave" number="26" ref="BarrierHit" />
2375
2376     <!-- ⋅⋅⋅ Errors (v1.0) ⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅⋅ -->
2377
2378     <error name="Device"     number="0" />
2379     <error name="Event"      number="1" />
2380     <error name="Mode"       number="2" />
2381     <error name="DeviceBusy" number="3" />
2382     <error name="Class"      number="4" />
2383
2384 </xcb>