Q3Tracker_GetEventCoordinates
You can use theQ3Tracker_GetEventCoordinates
function to get the settings (coordinates) of a tracker that were recorded at a particular moment (typically, the time of a button click) by a previous call toQ3Tracker_SetEventCoordinates
.
TQ3Status Q3Tracker_GetEventCoordinates ( TQ3TrackerObject trackerObject, unsigned long timeStamp, unsigned long *buttons, TQ3Point3D *position, TQ3Quaternion *orientation);
trackerObject
- A tracker object.
timeStamp
- A time stamp.
buttons
- On exit, the button state value of the specified tracker at the specified time.
position
- On exit, the position of the specified tracker at the specified time. If the tracker is absolute, this parameter contains the absolute coordinates of the tracker. If the tracker is relative, this parameter contains the change in position since the last call to
Q3Tracker_GetEventCoordinates
.orientation
- On exit, the orientation of the specified tracker at the specified time.
DESCRIPTION
TheQ3Tracker_GetEventCoordinates
function returns, in thebuttons
,position
, andorientation
parameters, the button state value, position, and orientation of the tracker specified by thetrackerObject
parameter, at the time specified by thetimeStamp
parameter. You can set any of thebuttons
,position
, andorientation
parameters toNULL
to preventQ3Tracker_GetEventCoordinates
from returning a value in that parameter.
Q3Tracker_GetEventCoordinates
selects the set of event coordinates whose time stamp is closest to the value specified in thetimeStamp
parameter. Any event coordinate sets that are older are discarded from the tracker's ring buffer. If the ring buffer is empty,Q3Tracker_GetEventCoordinates
returnskQ3Failure
.
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help