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 / Picking in a View


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.


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