Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 13 - View Objects / View Objects Reference
View Objects Routines / Bounding in a View


Q3View_EndBoundingBox

You can use the Q3View_EndBoundingBox function to stop computing an object's bounding box.

TQ3ViewStatus Q3View_EndBoundingBox (
TQ3ViewObject view, 
TQ3BoundingBox *result);
view
A view.
result
On exit, the bounding box for the objects specified in the bounding loop.
DESCRIPTION
The Q3View_EndBoundingBox function returns, as its function result, a view status value that indicates the current state of the bounding box calculation of the objects in the view specified by the view parameter. Q3View_EndBoundingBox returns one of these four values:

typedef enum TQ3ViewStatus {
   kQ3ViewStatusDone,
   kQ3ViewStatusRetraverse,
   kQ3ViewStatusError,
   kQ3ViewStatusCancelled
} TQ3ViewStatus;
If Q3View_EndBoundingBox returns kQ3ViewStatusDone, the bounding box calculation has completed. At that point, it is safe to exit your bounding loop. The result parameter contains the bounding box.

If Q3View_EndBoundingBox returns kQ3ViewStatusRetraverse, the bounding box calculation has not yet completed. You should respecify the model by reentering your bounding loop.

If Q3View_EndBoundingBox returns kQ3ViewStatusError, the bounding box calculation has failed. You should exit the bounding loop.

If Q3View_EndBoundingBox returns kQ3ViewStatusCancelled, the bounding box calculation has been canceled. You should exit the bounding loop.

SPECIAL CONSIDERATIONS
You should call Q3View_EndBoundingBox only if bounding box calculation is already occurring.


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