PK_MESH_imprint_vectors_r_t

struct PK_MESH_imprint_vectors_r_s
{
PK_imprint_vecs_t         status;          --- status
int                       n_error_indices; --- number of 'vectors' not on the
                                           --- mesh, or number of 'vectors'
                                           --- in bad "clusters"
int                      *error_indices;   --- indices of 'vectors' which
                                           --- caused the failure indicated
                                           --- by the status.
int                       n_defects;       --- number of defects in the
                                           --- 'resultant_mesh'
PK_MESH_defect_details_t *defects;         --- defects in the 'resultant_mesh'
};
typedef struct PK_MESH_imprint_vectors_r_s PK_MESH_imprint_vectors_r_t;



This structure is returned after attempting to imprint vectors on a mesh. It
holds a status identifying the nature of the success or failure, an array of
the indices of the vectors in the input array caused the failure, and an array
of defects in the 'resultant_mesh'.

Used in:

PK_MESH_imprint_vectors
PK_MESH_imprint_vectors_r_f

Any space allocated by Parasolid within this structure may be freed by calling
PK_MESH_imprint_vectors_r_f.

The structure has the following fields:

'status':            Token indicating whether the vectors were successfully
                     imprinted onto the mesh and whether there were any
                     defects in the 'resultant_mesh'.

                     Tokens that indicate success are:
                     PK_imprint_vecs_success_c,
                     PK_imprint_vecs_defects_c.

                     Tokens that indicate failure are:
                     PK_imprint_vecs_wrong_mtopol_c
                     PK_imprint_vecs_bad_parameter_c
                     PK_imprint_vecs_off_mesh_c
                     PK_imprint_vecs_bad_clusters_c.

                     PK_imprint_vecs_wrong_mtopol_c and
                     PK_imprint_vecs_bad_parameter_c take precedence over
                     PK_imprint_vecs_off_mesh_c and
                     PK_imprint_vecs_bad_clusters_c.

                     PK_imprint_vecs_off_mesh_c takes precedence over
                     PK_imprint_vecs_bad_clusters_c.

'error_indices':     If any of the vectors supplied were not within session
                     precision of the mesh, or were not within session
                     precision of their corresponding mtopol/parameter given
                     in the options structure, then this array will contain
                     the indices of those vectors in the input array.
                     Otherwise if any input vectors were in a cluster of
                     vectors which could not be resolved into a single vector
                     to imprint, the vectors from all such clusters will have
                     their indices from the input array included in
                     `error indices'. (See documentation for
                     PK_MESH_imprint_vectors for a definition of a "cluster".)
                     Otherwise this array will be null.

'defects':           An array of all the defects in the 'resultant_mesh'
                     caused by imprinting the vectors. If there are no such
                     defects this array will be null. Note that if there
                     were defects in the original mesh then there may be
                     defects in the 'resultant_mesh' which are not in the
                     array, as they were not caused by imprinting. However if
                     a vector is imprinted near an existing defect this may be
                     returned.