13 Picking in a View

13 Q3View_EndPicking

You can use the Q3View_EndPicking function to end picking in a view.

TQ3ViewStatus Q3View_EndPicking (TQ3ViewObject view);
view A view.

DESCRIPTION


The Q3View_EndPicking function returns, as its function result, a view status value that indicates the current state of the picking in the view specified by the view parameter. Q3View_EndPicking returns one of these four values:

typedef enum TQ3ViewStatus {
 kQ3ViewStatusDone,
 kQ3ViewStatusRetraverse,
 kQ3ViewStatusError,
 kQ3ViewStatusCancelled
} TQ3ViewStatus;
If Q3View_EndPicking returns kQ3ViewStatusDone, the picking has been completed and the specified view is no longer in picking mode. At that point, it is safe to exit your picking loop.

If Q3View_EndPicking returns kQ3ViewStatusRetraverse, the picking has not yet been completed. You should respecify the model by reentering your picking loop.

If Q3View_EndPicking returns kQ3ViewStatusError, the picking has failed because the renderer associated with the view encountered an error in processing the model. You should exit the picking loop.

If Q3View_EndPicking returns kQ3ViewStatusCancelled, the picking has been canceled. You should exit the picking loop.

SPECIAL CONSIDERATIONS


You should call Q3View_EndPicking only if picking 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