 |
PK_BODY_imprint_cus_vector |
|
PK_ERROR_code_t PK_BODY_imprint_cus_vector
(
--- 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_VECTOR_t direction, --- direction to project
--- curves in
const PK_BODY_imprint_cus_vector_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 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 tracking information returned consists of a single track record
(PK_TOPOL_track_record_r_t) with the 'product_topols' field holding
all edges created by the imprinting operation.
The 'original_topols' field of the track record will be empty.
This operation doesn't work on a wire body or any body whose faces have no
attached geometry,
See Imprinting for more information.