13 Bounding in a View

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

DESCRIPTION
SPECIAL CONSIDERATIONS

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker