libinput/doc
Peter Hutterer 8d9e7a1bcf Add an API to change pointer acceleration profiles
The quartett of new config functions is:
	libinput_device_config_accel_get_profiles
	libinput_device_config_accel_get_profile
	libinput_device_config_accel_set_profile
	libinput_device_config_accel_get_default_profile

The profile defines how the pointer acceleration works, from a very high-level
perspective. Two profiles are on offer, "adaptive", the standard one we have
used so far and "flat" which is a simple multiplier of input deltas and
provides 1:1 mapping of device movement vs pointer movement.

The speed setting is on top of the profile, a speed of 0 (default) is the
equivalent to "no pointer acceleration". This is popular among gamers and
users of switchable-dpi mice.

The flat profile unnormalizes the deltas, i.e. you get what the device does
and any device below 800dpi will feel excruciatingly slow. The speed range
[-1, 1] maps into 0-200% of the speed. At 200%, a delta of 1 is translated
into a 2 pixel movement, anything higher makes it rather pointless.

The flat profile is currently available for all pointer devices but touchpads.

https://bugs.freedesktop.org/show_bug.cgi?id=89485

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-09-11 00:54:01 +10:00
..
dot doc: add a diagram for evemu and note that libinput doesn't recordings 2015-08-24 09:36:22 +10:00
style doc: use bootstrap for doxygen styling 2015-07-16 14:15:19 +10:00
svg doc: add pointer acceleration documentation 2015-08-12 14:06:00 +10:00
absolute-axes.dox doc: fix more typos 2015-08-22 16:03:29 +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: use LIBINPUT_ATTR_SIZE_HINT for resolutions 2015-07-14 10:12:12 +10:00
faqs.dox doc: fix more typos 2015-08-22 16:03:29 +10:00
gestures.dox doc: fix more typos 2015-08-22 16:03:29 +10:00
libinput.doxygen.in doc: use bootstrap for doxygen styling 2015-07-16 14:15:19 +10:00
Makefile.am doc: add a diagram for evemu and note that libinput doesn't recordings 2015-08-24 09:36:22 +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 doc: fix typos 2015-08-17 16:26:43 +10:00
page-hierarchy.dox doc: add pointer acceleration documentation 2015-08-12 14:06:00 +10:00
palm-detection.dox doc: fix more typos 2015-08-22 16:03:29 +10:00
pointer-acceleration.dox Add an API to change pointer acceleration profiles 2015-09-11 00:54:01 +10:00
reporting-bugs.dox doc: add a diagram for evemu and note that libinput doesn't recordings 2015-08-24 09:36:22 +10:00
scrolling.dox touchpad: disable 2fg scrolling on Synaptics semi-mt touchpads 2015-07-27 19:34:42 +10:00
seats.dox doc: fix more typos 2015-08-22 16:03:29 +10:00
t440-support.dox doc: improve the T440 documentation a bit 2015-05-28 11:55:59 +10:00
tapping.dox doc: fix more typos 2015-08-22 16:03:29 +10:00
test-suite.dox doc: drop leftovers of Check's selective test running 2015-05-22 08:45:35 +10:00
tools.dox doc: fix more typos 2015-08-22 16:03:29 +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: don't tap for 2fg down, followed by a single finger up 2015-09-07 07:55:32 +10:00
touchpads.dox doc: fix more typos 2015-08-22 16:03:29 +10:00