 |
PK_BODY_imprint_curves_vector |
|
PK_ERROR_code_t PK_BODY_imprint_curves_vector
(
--- received arguments ---
PK_BODY_t body, --- a body
int n_curves, --- number of curves
const PK_CURVE_t curves[], --- curves
double tol, --- tolerance
PK_VECTOR_t direction, --- direction to project curves in
--- returned arguments ---
int *const n_edges, --- number of edges imprinted
PK_EDGE_t **const edges --- imprinted edges
)
This function imprints the given curves on the body by projecting them in the
given direction.
NOTE: This function is deprecated and has been superseded by PK_CURVE_project.
Specific Errors:
PK_ERROR_invalid_geometry Invalid curve
PK_ERROR_unsuitable_entity The target body or supplied curves are
unsuitable for this operation
PK_ERROR_cant_do_imprint Failed to perform imprint
Edges and vertices are added to the body. These are the image of the curves on
the body under projection in the supplied direction. The edges created by this
imprinting are returned. These may include existing edges where the curves
project down onto existing edges.
Note: Sometimes, it may be possible to imprint the 'curves' on the
'body' several times (for example, if the body is closed). In such
cases, if the projection of the 'curves' lies entirely within the
boundary of the 'body' when viewed along the supplied 'direction', the
'curves' are only imprinted onto the nearest face. In cases where
curves should be imprinted on several faces, call
PK_FACE_imprint_cus_vector with the required faces.
The tolerance supplied is used to solve any resolution problems and may also be
used to create SP-curves on the imprinted edges.
The curves supplied must be finite - only trimmed analytics and parametric
curves are supported.
This operation doesn't work on a wire body or any body whose faces have no
attached geometry,