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.