PK_FACE_imprint_cus_normal

PK_ERROR_code_t                       PK_FACE_imprint_cus_normal
(
--- received arguments ---
int                                   n_targets,     --- number of faces
const PK_FACE_t                       targets[],     --- array of faces
int                                   n_curves,      --- number of curves
const PK_CURVE_t                      curves[],      --- curves
PK_INTERVAL_t                         intervals[],   --- parametric intervals
                                                     --- of curves
double                                tol,           --- tolerance
const PK_FACE_imprint_cus_normal_o_t *options,       --- options

--- returned arguments ---
PK_TOPOL_track_r_t             *const tracking       --- tracking information
)


This function imprints the given array of curves on the given array of faces
( of the same body) by projecting them locally down the respective face
normals.

NOTE: This function is deprecated and has been superseded by PK_CURVE_project.



Specific Errors:

    PK_ERROR_invalid_geometry        Invalid curve (MILD)

    PK_ERROR_unsuitable_entity       Unsuitable curve type for operation
                                     (MILD)

    PK_ERROR_cant_do_imprint         Failed to perform imprint
                                     (MILD)

    PK_ERROR_wrong_entity_in_array  'targets' not all from same body
                                     (MILD)

    PK_ERROR_cant_complete_imprint   Failed to complete imprint
                                     (SERIOUS)

    PK_ERROR_ambiguous_imprint       Failed to complete because
                                     initial imprint is ambiguous
                                     (SERIOUS)

    PK_ERROR_bad_tolerance           The value of 'tol' and that of
                                     the 'max_projection_dist' within
                                     'options' are incompatible.
                                     'max_projection_dist' must be
                                     greater than 'tol'
                                     (MILD)


Edges and vertices are added to the faces. These are the image of the curves on
the faces under local projection down face normals. The edges created by this
imprinting are returned in the tracking structure. They may contain existing
edges where the curves project down onto existing edges.

The tolerance supplied is used to solve any resolution problems and may also be
used to create SP-curves on the imprinted edges.

The returned PK_TOPOL_track_r_t structure contains tracking records of type
PK_TOPOL_track_create_c the exact format of which is determined by the
tracking_type option.