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
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.


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