The swipe time threshold sets the maximum time (#samples) between the finger touch and finger release before it can be considered as a valid swipe. If the duration is too long (finger stays in contact with surface beyond Swipe Duration Threshold) the gesture is considered a tracking motion and is ignored.

Swipe Distance Minimum Threshold

The swipe distance threshold sets the minimum distance (measured points) a finger must travel before it can be considered for a valid swipe. If the distance traveled is too short, the gesture is ignored. Note: if the sensor's resolution is changed, this Swipe Distance Threshold should be re-scaled accordingly.

Implementation Notes

As an example, let's say we have a TrackPad with a resolution of 1000 points = 100 points per cm. If we want a minimum swipe distance to be 2cm (anything smaller is ignored), then set the Swipe Distance Threshold = 200 points.

Next, we want the swipe gesture to respond to quick swipe motions (a swipe less than 0.5 seconds) and ignore swipe motions that are longer than 0.5 seconds. In this example our sensor is measured every 10ms (100Hz), so we set the Swipe Time Maximum Threshold = 500ms/10ms = 50. In order for the swipe gesture to be valid, both Swipe Duration and Swipe Distance thresholds must be met. You can experiment with different duration and distance values to get the best feel for the size of your sensor.

Range of Valid Threshold Parameters
The Swipe Duration threshold may be set from 1 to 65535.

The Swipe Distance threshold may be set from 1 to 65535.

Affected Software Parameters
The Swipe Duation Threshold parameter corresponds to the
ui16SwipeTimeMax
member of the
tTrackPadSensorParams type in the CapTIvate Touch Library.

The Swipe Distance Threshold parameter corresponds to the ui16SwipeDistanceMin
member of the
tTrackPadSensorParams
type in the CapTIvate Touch Library.