Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference
QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Trackers


Q3Tracker_GetEventCoordinates

You can use the Q3Tracker_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 to Q3Tracker_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
The Q3Tracker_GetEventCoordinates function returns, in the buttons, position, and orientation parameters, the button state value, position, and orientation of the tracker specified by the trackerObject parameter, at the time specified by the timeStamp parameter. You can set any of the buttons, position, and orientation parameters to NULL to prevent Q3Tracker_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 the timeStamp parameter. Any event coordinate sets that are older are discarded from the tracker's ring buffer. If the ring buffer is empty, Q3Tracker_GetEventCoordinates returns kQ3Failure.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help