#include <FWHID_Contact.h>
Data Fields | |
int | frame_no |
The current frame number assigned by the device. | |
int | path_id |
1 to MAX_PATHS-1 | |
int | finger_id |
Best guess of which finger this Contact represents. | |
int | hand_id |
Best guess of which hand this Contact belongs to. | |
bool | identity_active |
Indicates that the Contact is debounced and active. | |
bool | untouch |
Used for debouncing the Contact. | |
double | xpos |
The X (horizontal) coordinate of the center of the Contact. | |
double | ypos |
The Y (vertical) coordinate of the center of the Contact. | |
double | xvel |
The X (horizontal) velocity of the Contact. | |
double | yvel |
The Y (vertical) velocity of the Contact. | |
double | proximity |
The normalized fingertip area/pressure of the Contact. | |
double | orientation |
Represents the orientation of the contact. | |
double | eccentricity |
Ratio of height/width of the Contact. | |
long | device_timestamp |
Timestamp of the Contact assigned by the device in milliseconds. | |
FWHID_AbsoluteTime | host_timestamp |
Timestamp of the Contact assigned by the host OS. |
A contact is a single contiguous surface image (typically fingers) which contains all the relevant position, velocity, and proximity/pseudo-pressure data. The contact is assigned a path_id with is constant across all consecutive frames where the contact is touching the surface. Also the device takes a best guess at which finger the contact is (finger_id). This guess changes as more contacts touch the surface.
|
Timestamp of the Contact assigned by the device in milliseconds. The range is ??????? |
|
Ratio of height/width of the Contact. The range is from 1 to 7.2 with a nominal value of ~1.8 |
|
Best guess of which finger this Contact represents. The finger_id is may not be constant across frames. It can change as more contacts touch the surface. If all five fingers from one hand touch the surface the finger_id's will mostly likely be all correct.
|
|
The current frame number assigned by the device. The range of values is 0-255 and then wraps around. |
|
Best guess of which hand this Contact belongs to.
|
|
Timestamp of the Contact assigned by the host OS.
|
|
Indicates that the Contact is debounced and active. This member and untouch comprise the debouncing of a contact.
|
|
Represents the orientation of the contact. The range of values is 0 to 180 degrees with a nominal values of 90. |
|
1 to MAX_PATHS-1 The pathID is constant across all consecutive frames where the contact is touching the surface. |
|
The normalized fingertip area/pressure of the Contact. The proximity is approximatly defined in square centimeters. The proximity data can be used at pseudo-pressure data. |
|
Used for debouncing the Contact. See identity_active for a description of how this member is used to debounce Contacts |
|
The X (horizontal) coordinate of the center of the Contact. The coordinate is defined in centimeters. |
|
The X (horizontal) velocity of the Contact. The velocity is defined in millimeters/second. |
|
The Y (vertical) coordinate of the center of the Contact. The coordinate is defined in centimeters. |
|
The Y (vertical) velocity of the Contact. The velocity is defined in millimeters/second. |