struct PK_FACE_inst_tools_r_s
    {
    int                     n_instances;
    int                    *instance_indices;
    int                     n_tracked_faces;
    PK_FACE_tracking_r_t   *tracked_faces;
    };
typedef struct PK_FACE_inst_tools_r_s PK_FACE_inst_tools_r_t;



This data structure indicates which of the instanced tools appear in the
resultant body.


Description of fields:



n_instances       The number of instanced tools which appear in the resultant
                    body, this may be less than the number of supplied
                    transforms, if for example one or more instanced tools miss
                    the target.


instance_indices  An integer array of length n_instances which indicates
                    those instances which appear in the resultant body. The
                    instance corresponding to the first transform in the given
                    array has index value 0, the second has index value 1 and
                    so on.

The following two fields are optionally returned.



n_tracked_faces   The number of faces in the tool body which are instanced
                    at least once in the resultant body.


tracked_faces     An array of structures of type PK_FACE_tracking_r_t,
                    one structure for each face in the tool body which is
                    instanced at least once in the resultant body.

The function PK_FACE_inst_tools_r_f may be used to free associated memory.