PK_SURF_find_self_int

PK_ERROR_code_t                  PK_SURF_find_self_int
(
--- received arguments ---
PK_SURF_t                        surf,       --- surface to be checked
const PK_SURF_find_self_int_o_t *options,    --- options structure

--- returned arguments ---
PK_SURF_self_ints_t       *const results     --- results
)


This function finds self-intersections in the given surface.


Specific Errors:
    PK_ERROR_invalid_geometry        The surface has invalidities other than
                                     self-intersections (PK_ERROR_mild)
    PK_ERROR_find_self_int_failed    Failure (PK_ERROR_serious)


This function finds regions of self-intersection on a surface, and returns
information about the regions found, if any.

Each self-intersection on the surface occupies a physical region in three-
space, and is made up of one or more parametric regions. The 'type' of each
self-intersection may be one of:
  o PK_self_int_type_general_c: Two or more distinct parameteric regions
    intersect each other.
  o PK_self_int_type_sing_c: A single parametric region has a singularity.
  o PK_self_int_type_mixed_c: Two or more distinct parametric regions intersect
    each other, but at least one of the parametric regions also has a
    singularity.