Use the same valuator axes for pointer and touch events

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Remove touch "Observe" grabs

The semantics of these grabs doesn't work for all use cases. Raw touch
events will likely work better.

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Fix up pointer event emulation section

* Wording cleanups for tense and to make some sentences flow better.
* Upon further review, it does seem to make more sense to deliver
  emulated pointer events through the same slave device rather than the
  master device. Thus, slave devices (including floating devices) may
  emit emulated pointer events.
* Peter is correct, it doesn't make sense to set the PointerEmulated
  flag on touch events.

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Peter is right, floating devices can emit touch events

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Prettyify touch device types

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Update device type terminology

Remove IndepedentTouch and SemiMultitouch devices. These may be handled
in an implementation specific manner through the props array of ATOMs in
the touch class information.

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Yes, send TouchEnd to owner, TouchPendingEnd to other listeners

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Separate "XI2.x" into "XI 2.x" for readability

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Merge remote-tracking branch 'origin/master' into multitouch

Conflicts:
XI2.h

Put a warning in about not adding any further libXi defines

The matching commit in libXi is
    e8531dd6a981c6cf19a1d256c29e886e34e8f51a
    libXi-1.4.2-21-ge8531ddp

    Add XI2 library-internal array offsets to XIint.h

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: add a linebreak for asciidoc parsing

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Provide convenience defines for owner_events.

No functional effect, just to improve readability of code.

It's not obvious what "True" or "False" stands for in a function with 11
arguments. Compare
    XIGrabButton(dpy, deviceid, button, grab_window, cursor,
                 GrabModeAsync, GrabModeSync, True,
                 event_mask, num_modifiers, &modifiers);

vs.

XIGrabButton(dpy, deviceid, button, grab_window, cursor,
             GrabModeAsync, GrabModeSync, XIOwnerEvents,
             event_mask, num_modifiers, &modifiers);

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Daniel Stone <daniel@fooishbar.org>

Add XI2-specific defines for grab and property requests

XI 2.0 headers forced clients to mix XI2 specific constants with defines for
core input. Most notable here are the grab code which required GrabModeAsync
or GrabModeSync from core, but _not_ AnyModifier (XIAnymodifier !=
AnyModifier). This is a hard-to-debug cause for bugs.

Add defines for grab modes, grab return codes and property modes as well as
a define for the AnyPropertyType. These defines are identical to the ones
defined in core but stop the use of input-related defines from either core
or XI 1.x.

Clients must use the core defines None and CurrentTime where applicable.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Daniel Stone <daniel@fooishbar.org>

Clean up and reword multitouch ownership/emulation

Remove 'withheld' indirect section as well.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Mostly typographical

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Further cleanups and clarifications

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Reword touch introduction, labels for all

Reword the introduction to the multitouch section to try to be a bit
clearer, and go on a mad section-labelling spree.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

typo fix

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Add FIXME sidebars, remove single-grab stipulation

Add very visible FIXME sections to more clearly mark what's broken; also
remove the stipulation that only one grab may be active at a time.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Add inline references, fix usecase bulleting

Replace 'see section x.y.z' with better inline links; fix nested
bulleting of XI 2.1 usecases.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Doc note: No seriously, this is WIP

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Formatting fixups and minor rewording

No semantic changes.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>

Require configure flag to build this proto version.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Put a #warning and #error in to avoid unsuspecting XI 2.1 users.

The #warning directive is intentionally outside the define to disable the
error. Early adopters of the protocol can't see this warning often enough.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2.h: Fix off-by-one error in the XIMaskLen definition.

The previous definition would give the wrong result for events that are
a multiple of 8.

Signed-off-by: Alexandre Julliard <julliard@winehq.org>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: enable asciidoc parsing for XIproto.txt

The vast majority of this patch are indentation changes, removing preceding
spaces from text.
Header lines  and some linebreaks to enable list parsing were added.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Gaetan Nadon <memsize@videotron.ca>

specs: move erroneous Errors: line to where it belongs

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Julien Cristau <jcristau@debian.org>

specs: rewrite pointer emulation section

plus a fixme

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: rewrite pointer emulation for indirect devices

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: Rewrite Touch events delivery section

And add a fixme

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: Add a fixme for using raw events instead of GrabModeObserve

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: clean/rewrite touch grab and ownership bits

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

spec: Move ClientPointer up again.

Prep work to have a separate first-class headline for touch processing

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: move warning about out-of-band processing up a bit.

The out-of-band processing is really only important for pointer emulation.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: move touch sequence handling (owner-only) up a bit.

This is to restructure to get the simple cases clarified up first before
explaining more complex changes.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: move from "init move destroy" to "begin update end"

And rewrite that paragraph a bit.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

specs: add a linebreak for asciidoc parsing

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Merge branch 'master' into chase-multitouch

Conflicts:
specs/XI2proto.txt

Fixed up (added) asciidoc for touch proto.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIproto.txt: fix whitespace issues

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

XI2proto.txt: fix whitespace issues

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

specs: convert XI2proto.txt to html using asciidoc

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

Add minimal asciidoc syntax

Though this protocol description is mainly to be viewed as textfile, a few
minor changes make it parsable for asciidoc to spit out reasonably
nicely-formatted html code.

Changes include:
- underline section headers with the matching lines
- add linebreaks before lists to parse them as lists
- change indentation level for normal text to be left-marging aligned and
  for <pre> text to be indented
- comment out section dividers

It's possible to run asciidoc XI2proto.txt and get some nice html output
now.

Reviewed-by: Gaetan Nadon <memsize@videotron.ca>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Chase Douglas <chase.douglas@canonical.com>

Many more updates to the XI 2.1 protocol

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Updates for pointer emulation and more touch device modes

Also includes resolutions for dependent devices and implicit grabs and
how to handle slave touch device attachment and touch selections.

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>

Add touch classes and events, bump to 2.1

Introduce multitouch support through a new TouchClass, as well as new
TouchBegin, TouchEnd, TouchOwnership, TouchUpdate, and TouchUpdateUnowned
events.  Bump to version 2.1.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>
Co-authored-by: Chase Douglas <chase.douglas@canonical.com>
Co-authored-by: Peter Hutterer <peter.hutterer@who-t.net>

Fix typos in XIproto.txt

Signed-off-by: Fernando Carrijo <fcarrijo@freedesktop.org>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Include stdint.h

I'm now getting build failures due to missing stdint.h. It seems we
should include it explicitly in XI2proto.h anyways.

Signed-off-by: Chase Douglas <chase.douglas@canonical.com>
Signed-off-by: Daniel Stone <daniel@fooishbar.org>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 2.0.1

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Typo fix: GrabTypeFocusIn -> GrabtypeFocusIn

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Spell out event types for XIDeviceEvent.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Define the error cases for XSetDeviceMode better.

Take the error codes as described in the man page for XSetDeviceMode. This
is more likely to be what clients expect, especially since the protocol spec
doesn't actually define when BadMode is to be reported.

This behaviour is the same as specified in the XSetDeviceMode man page.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Fernando Carrijo <fcarrijo@yahoo.com.br>

XI2proto.txt: fix up some request names.

Leftovers from previous versions of the spec before the requests were
renamed.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

config: update AC_PREREQ statement to 2.60

Unrelated to the previous patches, the new value simply reflects
the reality that the minimum level for autoconf to configure
all x.org modules is 2.60 dated June 2006.

ftp://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

config: remove the pkgconfig pc.in file from EXTRA_DIST

Automake always includes it in the tarball.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

config: install and distribute XI2proto.txt XIproto.txt

It will now be installed in $docdir in addition
to being distributed in the tarball.

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

Add Red Had Copyright in the COPYING file.

Refer to XI2.h and XI2proto.h

Signed-off-by: Gaetan Nadon <memsize@videotron.ca>

Makefile.am: add ChangeLog and INSTALL on MAINTAINERCLEANFILES

Now that the INSTALL file is generated.
Allows running make maintainer-clean.

README: file created or updated #24206

Contains a set of URLs to freedesktop.org.

Makefile.am: ChangeLog not required: EXTRA_DIST or *CLEANFILES #24432

ChangeLog filename is known to Automake and requires no further
coding in the makefile.

Makefile.am: INSTALL file is missing or incorrect #24206

The standard GNU file on building/installing  tarball is copied
using the XORG_INSTALL macro contained in XORG_DEFAULT_OPTIONS
Add INSTALL target

configure.ac: deploy the new XORG_DEFAULT_OPTIONS #24242

This macro aggregate a number of existing macros that sets commmon
X.Org components configuration options. It shields the configuration file from
future changes.

configure.ac: AM_MAINTAINER_MODE missing #24238

This turns off maintainer mode build rules in tarballs.
Works in conjunction with autogen.sh --enable-maintainer-mode

.gitignore: use common defaults with custom section # 24239

Using common defaults will reduce errors and maintenance.
Only the very small or inexistent custom section need periodic maintenance
when the structure of the component changes. Do not edit defaults.

inputproto 2.0

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add XIproto.txt

This is the XI protocol specification document that used to be in xorg-docs.
It's now moved here, and if it ever sees updates, the updates will only
apply to here.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Require macros 1.3 for XORG_DEFAULT_OPTIONS

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.902 (RC 2)

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Device cursors are deleted once the window or the device disappear.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIWarpPointer needs to take FP1616 for positions.

This was already in the spec but the protocol itself hadn't cought up with
it.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Replace four leftover INT16 with int16_t.

XIQueryPointer only works on master pointers and floating slaves.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto: XIChangeCursor request requires a master pointer.

State that the server will return BadDevice in this case.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: typo fix

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Remove eventtype field from xXIRawEvent.

With c455db2, raw events were split up into using multiple evtypes instead
of a sub event type. The eventtype field itself however has not been removed
and was unused by both the server and the library.

Field converted into a padding field, wire layout stays the same.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.901 (RC 1)

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Revert "XI2proto.txt: grabbing a slave does not detach it anymore."

Detaching a slave device during an explicit grab makes sense from a UI
perspective. It allows a client to get exclusive access to a device without
that device's events also feeding into the respective master device.

Thanks to Thomas Jaeger for his contribution.

This reverts commit d0b1e55b876a29a7c820ec12d7b9cb5e081e1944.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: document ClientPointer in more detail.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: don't put field names in quotes.

This was done inconsistently anyway so get rid of it alltogether.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: typo fixes and minor clarifications.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: sourceid on DeviceChanged is the device.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: passive grabs can take XIAll{Master}Devices.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: grabbing a slave does not detach it anymore.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIproto.txt: clarify that the ClientPointer is set, even if implicitly.

It is indistinguishable for the client whether the the server chooses a
ClientPointer or whether the CP was set through an XISetClientPointer
request. The only thing that matters is that a device was actually assigned
and will be used in the future.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: padding bytes must be zero.

Padding bytes zeroed out ensures that future versions of the XI2 protcol may
use these padding bytes with a defined state. The server should ignore
padding bytes depending on the client's version anyway but better safe than
sorry.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.h: Remove special doxygen tags.

The protocol header does not include enough documentation to make the use of
doxygen really worthwile. Special doxygen tags beyond the very simple use of
/** and /**< contribute too much to the noise and make it hard to actually
read the code itself.

While no extra tags are added now, a run of doxygen over XI2proto and XI.h
still produces an acceptable output.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: Add some XI1 vs. XI2 interoperability descriptions.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2proto.txt: update list of XI2 event types.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.15

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2: remove Keysym grabs, use Keycode grabs instead.

Keysym grabs are tricky to get right for applications that are more
complicated than demo applications. otoh, we know keycode grabs are working.
So let's go with keycode grabs for now and add keysym grabs later when we've
sorted out the details.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.14

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Add the enter/leave detail defines, same as the core protocol ones.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Formatting fix, s/tabs/spaces/

Device{,Raw}Event: Add flags field.

Add a flags member to DeviceEvent and DeviceKeyEvent; the only currently
defined flag is KeyRepeat, indicating a repeat event (a la XKB detectable
autorepeat), which is only valid for key events.

Signed-off-by: Daniel Stone <daniel@fooishbar.org>
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XI2: Split up raw events into multiple event types.

Instead of a single XI_RawEvent type with subtypes to represent the actual
event, split up the event into XI_RawButtonPress, XI_RawButtonRelease, etc.
This way clients can select for specific raw events only instead of all of
them at once.

Note that raw events may be selected on master devices too, the server will
route them through master devices.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Fix XIMaskLen macro.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.13

Add effective group and modifiers to XIGroupInfo/XIModifierInfo.

Effective modifiers are easy to calculate but let's send them down the wire
nonetheless. Effective group is slightly more complicated since group
wrapping must be taken into account - sending it down the wire simplifies
clients.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

XIDeviceChangedEvents may occur on master devices too.

Prime example is a change in the number of buttons due to the availability
of a new slave device.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

inputproto 1.9.99.12

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Use the term 'labels' to refer to button and axes labels.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>