Q3View_EndPicking
You can use theQ3View_EndPicking
function to end picking in a view.
TQ3ViewStatus Q3View_EndPicking (TQ3ViewObject view);
view
- A view.
DESCRIPTION
TheQ3View_EndPicking
function returns, as its function result, a view status value that indicates the current state of the picking in the view specified by theview
parameter.Q3View_EndPicking
returns one of these four values:
typedef enum TQ3ViewStatus { kQ3ViewStatusDone, kQ3ViewStatusRetraverse, kQ3ViewStatusError, kQ3ViewStatusCancelled } TQ3ViewStatus;IfQ3View_EndPicking
returnskQ3ViewStatusDone
, 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
returnskQ3ViewStatusRetraverse
, the picking has not yet been completed. You should respecify the model by reentering your picking loop.If
Q3View_EndPicking
returnskQ3ViewStatusError
, 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
returnskQ3ViewStatusCancelled
, the picking has been canceled. You should exit the picking loop.SPECIAL CONSIDERATIONS
You should callQ3View_EndPicking
only if picking is already occurring.
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help