Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference

Application-Defined Routines /

TQ3TrackerNotifyFunc

You can define a tracker notify function that QuickDraw 3D calls when a controller associated with a tracker has new data.

typedef TQ3Status (*TQ3TrackerNotifyFunc) (
TQ3TrackerObject trackerObject, 
TQ3ControllerRef controllerRef);

trackerObject

A tracker object.

controllerRef

A reference to a controller.

DESCRIPTION

Your TQ3TrackerNotifyFunc function is called whenever any controller associated with a tracker has new data to be processed and the data meets or exceeds the current position and orientation thresholds for the tracker. The affected controller and tracker are passed in the controllerRef and trackerObject parameters. Your tracker notify function might, for example, schedule your application to awaken and redraw the scene.

SPECIAL CONSIDERATIONS

Your tracker notify function might be called at interrupt time, but it is never called reentrantly.

RESULT CODES

Your tracker notify function should return kQ3Success if it is successful and kQ3Failure otherwise.

SEE ALSO

See the description of Q3Tracker_New on page 18-34 for information on setting the notify function of a tracker.