PK_BODY_imprint_cus_normal

PK_ERROR_code_t                       PK_BODY_imprint_cus_normal
(
--- received arguments ---
PK_BODY_t                             body,         --- a body
int                                   n_curves,     --- number of curves
const PK_CURVE_t                      curves[],     --- curves
const PK_INTERVAL_t                   intervals[],  --- parametric intervals
                                                    --- of curves
double                                tol,          --- tolerance
const PK_BODY_imprint_cus_normal_o_t *options,      --- options

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


This function imprints the given curves on the body by projecting them locally
down 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      The target body or supplied curves
                                    are unsuitable for this operation
                                    (MILD)

    PK_ERROR_cant_do_imprint        Failed to perform imprint
                                    (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 body. These are the image of the curves on
the body under local projection down face normals. The edges created by this
imprinting are returned. These may include 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.

This operation doesn't work on a wire body or any body whose faces have no
attached geometry,

See Imprinting for more information.