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

Chapter 13 - View Objects / View Objects Reference

View Objects Routines / Rendering in a View

Q3View_Cancel

You can use the Q3View_Cancel function to cancel the rendering, picking, bounding, or writing operation currently occurring in a view.

TQ3Status Q3View_Cancel (TQ3ViewObject view);

view

A view.

DESCRIPTION

The Q3View_Cancel function interrupts the process of rendering an image of a model, submitting objects for picking, calculating a bounding box or sphere, or writing data to a file in accordance with the view specified by the view parameter. Any subsequent calls to _Submit routines for the specified view will fail, and Q3View_EndRendering (or the similar call for picking, bounding, or writing) will return kQ3ViewStatusCancelled when it is next executed. Note that you must still call Q3View_EndRendering (or the similar call for picking, bounding, or writing) after you have called Q3View_Cancel.

You can call Q3View_Cancel at any time. If the specified view is not in the submitting state, Q3View_Cancel returns kQ3Failure.