1.9.1.2 qtm_gestures_2d_config _t
The qtm_gestures_2d_config _t data structure is the configuration structure passed to the module.
| Field | Unit | Range/Options | Parameter |
|---|---|---|---|
| horiz_position0 | uint16_t | Pointer | Pointer to the horizontal contact 0 position. |
| vertical_position0 | uint16_t | Pointer | Pointer to the vertical contact 0 position. |
| surface_status0 | uint8_t | Pointer | Pointer to the status of contact 0. |
| horiz_position1 | uint16_t | Pointer | Pointer to the horizontal contact 1 position. |
| vertical_position1 | uint16_t | Pointer | Pointer to the vertical contact 1 position. |
| surface_status1 | uint8_t | Pointer | Pointer to the status of contact 1. |
| surface_resolution | uint8_t | 0 to 255 | This parameter defines the resolution of surface. |
| tapReleaseTimeout | uint8_t | 0 to 255 | This parameter limits the amount of time
allowed between the initial finger press and the liftoff. Exceeding this
value will cause the firmware to not consider the gesture as a tap
gesture. Note: This value should be lesser
than tapHoldTimeout and swipeTimeout. |
| tapHoldTimeout | uint8_t | 0 to 255 | If a finger stays within the bounds set
by TAP_AREA and is not removed, the firmware will report a Tap Hold
gesture once the gesture timer exceeds this value. Note: This should be greater than the
tapReleaseTimeout and swipeTimeout.
|
| swipeTimeout | uint8_t | 0 to 255 | This value limits the amount of time
allowed for the swipe gesture (initial finger press, moving in a
particular direction, crossing the distance threshold and the
liftoff). Note: This should be greater than the
tapReleaseTimeout and lesser than tapHoldTimeout. |
| xSwipeDistanceThreshold | uint8_t | 0 to 255 | This controls the distance traveled in the X-axis direction for detecting Left and Right Swipe gestures. |
| ySwipeDistanceThreshold | uint8_t | 0 to 255 | This controls the distance traveled in the Y-axis direction for detecting Up and Down Swipe gestures. |
| edgeSwipeDistanceThreshold | uint8_t | 0 to 255 | This controls the distance traveled for Edge Swipe gestures. |
| tapDistanceThreshold | uint8_t | 0 to 255 | This parameter bounds the finger to an area it must stay within to be considered a Tap gesture when the finger is removed and Tap and Hold gesture if the finger is not removed for some time. |
| seqTapDistanceThreshold | uint8_t | 0 to 255 | This parameter limits the allowable distance of the current touch’s initial press from the liftoff position of the previous touch. It is used for multiple taps (double-tap, triple-tap, etc.).If the taps following the first are within this threshold, then the tap counter will be incremented. If the following tap gestures exceed this threshold, the previous touch is sent as a single tap, and the current touch will reset the tap counter. |
| edgeBoundary | uint8_t | 0 to 255 | The firmware can also be modified to define an edge region along the border of the touch sensor. With this defined, Swipe gestures that start in an edge region will be reported as Edge Swipe gestures in place of normal Swipe gestures. |
| wheelPostscaler | int8_t | -128 to 127 | This parameter adjusts the rate at which the Wheel gesture is updated in the GUI. |
| wheelStartQuadrantCount | int8_t | -128 to 127 | The Wheel gesture movement can be broken down into 90° arcs. The firmware watches for a certain number of arcs to occur in a circular pattern before starting to report Wheel gesture information. The number of arcs that must be first detected is determined by this parameter. Lower values for this parameter make it faster to start a wheel gesture, but it also makes the firmware prone to prematurely reporting wheel gesture information. |
| wheelReverseQuadrantCount | int8_t | -128 to 127 | This parameter functions like wheelStartQuadrantCount, except it is used when changing the direction of the wheel instead of starting it new. This is used to prevent quick toggling between directions. |
| pinchZoomThreshold | uint8_t | 0 to 255 | This parameter limits the allowable distance between the two fingers to detect the pinch and the zoom gestures. After crossing this parameter value, if the distance between the contacts is reducing, then the gesture is reported as “PINCH”. After crossing this parameter value, if the distance between the contacts is increasing, then the gesture is reported as “ZOOM”. |