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_SetEventCoordinates

You can use the Q3Tracker_SetEventCoordinates function to record the settings (coordinates) of a tracker at a particular time.

TQ3Status Q3Tracker_SetEventCoordinates (
TQ3TrackerObject trackerObject, 
unsigned long timeStamp, 
unsigned long buttons, 
const TQ3Point3D *position, 
const TQ3Quaternion *orientation);

trackerObject

A tracker object.

timeStamp

A time stamp.

buttons

The button state value of the specified tracker, or NULL.

position

The position of the specified tracker, or NULL.

orientation

The orientation (in radians) of the specified tracker, or NULL.

DESCRIPTION

The Q3Tracker_SetEventCoordinates function places into the ring buffer of event coordinates for the tracker specified by the trackerObject parameter the values specified in the buttons, position, and orientation parameters. The event coordinates are marked with the time stamp specified by the timeStamp parameter. If the tracker's ring buffer is full, the oldest item in the buffer is discarded.

Note

A tracker's ring buffer can contain up to 10 items. Time stamps of items in the buffer increase from oldest to newest.

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