Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 15 - Pick Objects / Pick Objects Reference
Pick Objects Routines / Managing Pick Objects


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. QuickDraw 3D 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.


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