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_EndBoundingSphere

You can use the Q3View_EndBoundingSphere function to stop computing an object's bounding sphere.

TQ3ViewStatus Q3View_EndBoundingSphere (
TQ3ViewObject view, 
TQ3BoundingSphere *result);
view
A view.
result
On exit, the bounding sphere for the objects specified in the bounding loop.
DESCRIPTION
The Q3View_EndBoundingSphere function returns, as its function result, a view status value that indicates the current state of the bounding sphere 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_EndBoundingSphere returns kQ3ViewStatusDone, the bounding sphere calculation has completed. At that point, it is safe to exit your bounding loop. The result parameter contains the bounding sphere.

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

If Q3View_EndBoundingSphere returns kQ3ViewStatusError, the bounding sphere calculation has failed. You should exit the bounding loop.

If Q3View_EndBoundingSphere returns kQ3ViewStatusCancelled, the bounding sphere calculation has been canceled. You should exit the bounding loop.

SPECIAL CONSIDERATIONS
You should call Q3View_EndBoundingSphere only if bounding sphere 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