
PK_FACE_imprint_curves_isocline
PK_ERROR_code_t PK_FACE_imprint_curves_isocline
(
--- received arguments ---
int n_rec_faces, --- number of received faces (>0)
const PK_FACE_t rec_faces[], --- received faces
PK_VECTOR1_t direction, --- isocline direction
double angle, --- isocline angle
double tolerance, --- max tol for applying surfs
--- returned arguments ---
int *const n_ret_faces, --- number of returned faces (>=0)
PK_FACE_t **const ret_faces, --- returned faces (optional)
PK_LOGICAL_t **const is_steep, --- whether faces are steep (optional)
int *const n_edges, --- number of new edges (>=0)
PK_EDGE_t **const edges --- new edges (optional)
)
This function creates and imprints isocline curves on a given set of faces.
NOTE: This function is obsolete and has been superseded
by PK_FACE_imprint_cus_isoclin
The isocline is specified by a direction and an angle.
The function may, at times, have to use approximate geometry.
For such cases, tolerance specifies an upper bound on the distance by which
a point on the actual geometry may deviate from its ideal position.
While the function will usually satisfy this constraint, it is not guaranteed.
The set ret_faces is the union of rec_faces and any newly created faces.
In ret_faces, each given face from rec_faces is immediately followed by
any additional faces that have been created from it. By definition, each face
in ret_faces is not steep or all steep. `is_steep[i]' reports whether
`ret_faces[i]' is steep.
The new edges created are returned in edges.
The output array ret_faces is optional. If it is set to NULL, the function
will only output the number of resulting faces. The output array is_steep is
optional. It may not be non-NULL if ret_faces is NULL.
The output array edges is optional. If it is set to NULL the function will
only output the number of new edges.