PK_FACE_inst_tools_r_t

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.

Used in:

PK_FACE_inst_tools_r_f
PK_FACE_instance_tools

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.

Note: If the 'merge_imprinted' option in PK_FACE_boolean_o_t is switched on,
any faces that are created during the instancing operation which are
subsequently merged out will not be recorded in 'n_tracked_faces' or
'tracked_faces'.

The function PK_FACE_inst_tools_r_f may be used to free associated memory.