Q3Group_GetNextObjectPosition (IM: QD3D)

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Getting Object Positions

Q3Group_GetNextObjectPosition
You can use the Q3Group_GetNextObjectPosition function to get the position of the next instance of an object in a group.
TQ3Status Q3Group_GetNextObjectPosition (
TQ3GroupObject group, 
TQ3Object object, 
TQ3GroupPosition *position);
group
A group.
object
An object.
position
On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the next instance of the specified object.

DESCRIPTION
The Q3Group_GetNextObjectPosition function returns, in the position parameter, the position of the next instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the last instance of that object in the group, Q3Group_GetNextObjectPosition returns the value NULL in the position parameter.

ERRORS
kQ3ErrorInvalidObject kQ3ErrorInvalidPositionForGroup kQ3ErrorNULLParameter