From 9d84dddf91dcbcbf8ed70f143520998d5f775814 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Tue, 2 Jun 2015 15:45:37 +1000 Subject: [PATCH] doc: add a graphic to explain tap-n-drag Signed-off-by: Peter Hutterer --- doc/Makefile.am | 1 + doc/svg/tap-n-drag.svg | 810 +++++++++++++++++++++++++++++++++++++++++ doc/tapping.dox | 23 +- 3 files changed, 826 insertions(+), 8 deletions(-) create mode 100644 doc/svg/tap-n-drag.svg diff --git a/doc/Makefile.am b/doc/Makefile.am index 9407f133..58ae2161 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -33,6 +33,7 @@ diagram_files = \ $(srcdir)/svg/button-scrolling.svg \ $(srcdir)/svg/edge-scrolling.svg \ $(srcdir)/svg/palm-detection.svg \ + $(srcdir)/svg/tap-n-drag.svg \ $(srcdir)/svg/top-software-buttons.svg \ $(srcdir)/svg/twofinger-scrolling.svg diff --git a/doc/svg/tap-n-drag.svg b/doc/svg/tap-n-drag.svg new file mode 100644 index 00000000..5c84beb7 --- /dev/null +++ b/doc/svg/tap-n-drag.svg @@ -0,0 +1,810 @@ + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a) Tap + b) Hold down + c) Move + d) Reset finger, move (optional) + f) Tap to end (optional) + e) Release + diff --git a/doc/tapping.dox b/doc/tapping.dox index 7eb81e62..1337fc53 100644 --- a/doc/tapping.dox +++ b/doc/tapping.dox @@ -27,15 +27,22 @@ libinput_device_config_tap_set_enabled() for details. libinput also supports "tap-and-drag" where a tap immediately followed by a finger down and that finger being held down emulates a button press. Moving -the finger around can thus drag the selected item on the screen. Lifting the -finger and putting it back down immediately (i.e. within the timeout) will -continue the dragging process, so that multiple touchpad-widths of distance -can be covered easily. If two-fingers are supported by the hardware, a -second finger can be used to drag while the first is held in-place. +the finger around can thus drag the selected item on the screen. -An alternative method to end a drag process is to tap immediately after -lifting the finger. The full sequence is thus: tap, finger down, drag, -finger up, tap. +@image html tap-n-drag.svg "Tap-and-drag process" + +The above diagram explains the process, a tap (a) followed by a finger held +down (b) starts the drag process and logically holds the left mouse button +down. A movement of the finger (c) will drag the selected item until the +finger is relased (e). If needed, the finger's position can be reset by +lifting and quickly setting it down again on the touchpad (d). This will be +interpreted as continuing move and is especially useful on small touchpads +or with slow pointer acceleration. +The release of the mouse buttons after the finger release (e) is triggered +by a timeout. To release the button immediately, simply tap again (f). + +If two fingers are supported by the hardware, a second finger can be used to +drag while the first is held in-place. @section tap_constraints Constraints while tapping