Q3ViewerEvent (IM: QD3D)

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

Chapter 2 - 3D Viewer / 3D Viewer Reference

3D Viewer Routines / Handling Viewer Events

Q3ViewerEvent
You can use the Q3ViewerEvent function to give the 3D Viewer an opportunity to handle events involving a viewer object.
Boolean Q3ViewerEvent (
TQ3ViewerObject theViewer, 
EventRecord *evt);
theViewer
A viewer object.
evt
An event record.

DESCRIPTION
The Q3ViewerEvent function returns, as its function result, a Boolean value that indicates whether the event specified by the evt parameter relates to the viewer object specified by the theViewer parameter and was successfully handled (TRUE) or whether that event either does not relate to that viewer object or could not be handled by the 3D Viewer (FALSE). The evt parameter is a pointer to an event record, which you usually obtain by calling the Event Manager function WaitNextEvent.
Q3ViewerEvent can handle most of the events relating to a viewer object. For example, it handles all user events relating to the controller strip displayed with a viewer object. For information on how to handle editing commands in a viewer pane, see "Handling Edit Commands," beginning on page 2-31.

SPECIAL CONSIDERATIONS
You should call Q3ViewerEvent in your main event loop to give the 3D Viewer an opportunity to handle events in a window that relate to a viewer object.