15 Managing Pick Objects

15 Q3Pick_GetHitData

You can use the Q3Pick_GetHitData function to get an item in the hit list of a pick object.

TQ3Status Q3Pick_GetHitData (
TQ3PickObject pick, 
unsigned long index, 
TQ3HitData *hitData);
pick A pick object.
index An index into a hit list. This number should be between 0 and one less than the number of items in the hit list of the specified pick object, inclusive.
hitData On entry, a pointer to a hit data structure. On exit, a pointer to a hit data structure for the specified item in the hit list of the specified pick object.

DESCRIPTION


The Q3Pick_GetHitData function returns, in the hitData parameter, a pointer to a hit data structure for the item that has the index specified by the index parameter in the hit list associated with the pick object specified by the pick parameter. The hit data structure whose address is passed in the hitData parameter must be created by your application. QuickDraw3D allocates memory to hold any additional information returned in the hit data structure; you should call Q3Hit_EmptyData to dispose of that memory when you are finished using the hit data.

DESCRIPTION

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