13 Bounding in a View

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

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