OSDN Git Service

Fixes and improvements related to touch screen gestures.
authorMichael Curran <mick@nvaccess.org>
Tue, 15 Dec 2015 05:58:57 +0000 (15:58 +1000)
committerJames Teh <jamie@nvaccess.org>
Fri, 22 Jan 2016 02:55:03 +0000 (12:55 +1000)
commitd7014ebc378cabd117b0465ce1da94cef43f74a1
tree36088aedcf97791f892b44e404d5aef819fa9e6b
parentfb0c328c8e371131a7493229bc50c9e084806d75
Fixes and improvements related to touch screen gestures.

* All taps that overlap in time are correctly merged into one multi-finger tap. Previously tap A and B would be merged only if B started after A's start but before its end.
* Taps are only merged into plural (double, tripple, quadruple) taps if there are no other unknown trackers at the time. This stops a tap quickly followed by a tripple tap for example, from incorrectly turning into a quadruple tap.
* Plural tap and holds (e.g. double tap and hold) are now detected.
* Hover downs are no longer fired when part of a tapAndHold.
* Hovers are no longer reported in input help.
* MultitouchTracker objects now contain a childTrackers property which contains the multiTouchTrackers it is made up of (I.e. 2 finger double tap contains 2 2-finger taps. The 2-finger taps themselves contain 2 taps).
* MultiTouchTracker objects now also contain a rawSingleTouchTracker property, if this tracker is the result of one single finger doing a tap, flick or hover. The SingleTouchTracker allows access to the underlying Operating System assigned ID for the finger and whether or not the finger is still in contact at the current time.
* Added doc strings to MultiTouchTracker and SingleTouchTracker classes explaining all available properties
* Provide __slots__ on MultiTouchTracker and SingleTouchTracker classes to decrease their size.
* The Touch input Gesture class's doc string now explains all possible actions that can occur
* Touch input gestures now have x and y properties, removing the need to access the tracker in very simple cases.
* Gesturs now contain a preheldTracker property, which is a multitouchTracker object representing the other held fingers while this action was being performed.
* Gesture identifier IDs are now output in Python set order ensuring correct comparisons, allowing gestures such as "1finger_hold+hover" to be correctly bound.
* A generalized identifier with finger count removed is now included for holds (e.g. hold+hover for 1finger_hold+hover).

Fixes #5652.
source/globalCommands.py
source/inputCore.py
source/touchHandler.py
source/touchTracker.py
user_docs/en/changes.t2t