libinput/doc
Peter Hutterer c06d825c53 Drop motion normalization of unaccelerated deltas
This simply doesn't work for low-dpi mice. Normalizing a 400dpi mouse to a
1000dpi mouse forces a minimum movement of 2.5 units and the resulting pixel
jumps. It is impossible for the caller to detect whether the jump was caused
by a single motion or multiple motion events.

This is technically an API break, but not really.

The accelerated data was already relatively meaningless, even if normalized as
the data did not correspond predictably to any input motion (unless you know
the implementation acceleration function in the caller). So we can drop the
mention from there without expecting any ill effects in the caller.

The unaccelerated data was useless for low-dpi mice and could only be used to
measure the physical distance of the mouse movement - something not used in
any caller we're aware of (if needed, we can add that functionality as a
separate call). Dropping motion normalization for unaccelerated deltas also
restores true dpi capabilities to users of that API, mostly games that want to
make use of high-dpi mice.

This is a simplified patch, the normalization is still in place for most of
libinput, it merely carries the original coordinates in the event itself.

In the case of touchpads, the coordinates are unnormalized into the x-axis
coordinate space as per the documentation.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-07-02 13:03:43 +10:00
..
dot doc: add a FAQ page 2015-06-01 15:43:58 +10:00
svg touchpad: impose maximum distance limits on clickfingers 2015-06-03 14:43:58 +10:00
absolute-axes.dox doc: document the calibration as well 2014-12-22 12:57:48 +10:00
clickpad-softbuttons.dox touchpad: impose maximum distance limits on clickfingers 2015-06-03 14:43:58 +10:00
device-configuration-via-udev.dox evdev: add support for LIBINPUT_MODEL_* udev tags 2015-04-24 08:38:58 +10:00
faqs.dox doc: add a FAQ page 2015-06-01 15:43:58 +10:00
libinput.doxygen.in doc: move DOTFILE_DIRS to libinput.doxygen.in 2015-01-15 11:48:15 +10:00
Makefile.am doc: add a graphic to explain tap-n-drag 2015-06-02 15:47:33 +10:00
middle-button-emulation.svg evdev: add support for middle button emulation 2015-04-17 12:50:03 +10:00
normalization-of-relative-motion.dox Drop motion normalization of unaccelerated deltas 2015-07-02 13:03:43 +10:00
palm-detection.dox touchpad: touches after the last key press can be released 2015-05-27 17:38:25 +10:00
scrolling.dox doc: make horizontal scrolling a separate section 2015-06-10 07:56:57 +10:00
seats.dox doc: improve seat documentation 2014-12-22 12:57:48 +10:00
t440-support.dox doc: improve the T440 documentation a bit 2015-05-28 11:55:59 +10:00
tapping.dox Add configuration interface for tap drag-lock 2015-06-23 14:24:29 +10:00
test-suite.dox doc: drop leftovers of Check's selective test running 2015-05-22 08:45:35 +10:00
touchpad-edge-scrolling-state-machine.svg touchpad: Add edge-scrolling support 2014-11-25 17:02:30 +10:00
touchpad-softbutton-state-machine.svg touchpad: Route top softbuttons through the trackstick if we've one 2014-09-19 08:20:00 +10:00
touchpad-tap-state-machine.svg touchpad: hook up drag lock configuration 2015-06-23 14:24:29 +10:00