PK_EDGE_reset_precision

PK_ERROR_code_t        PK_EDGE_reset_precision
(
--- received arguments ---
PK_EDGE_t              edge,      --- edge

--- returned arguments ---
PK_reset_prec_t *const result
)


This function attempts to reset the precision of the given 'edge' to the
session precision: that is to make Parasolid regard the edge as exact.

NOTE: This function is deprecated and has been superseded by
PK_EDGE_reset_precision_2.



The function aims to remove all fin curves and delete them if possible and
to represent the geometry of the edge by a single curve attached to the edge.
This operation may not always be possible - the level of success is indicated
by 'result' which can take the following values:

   PK_reset_prec_ok_c             geometry successfully replaced and precision
                                  set to session precision

   PK_reset_prec_tangent_c        geometry not replaced and precision
                                  unaltered because surfaces are approximately
                                  tangential at edge

   PK_reset_prec_missing_geom_c   not enough geometry present on edge or
                                  adjacent faces to recompute edge geometry

   PK_reset_prec_failure_c        recomputation of edge geometry failed.

PK_EDGE_reset_precision attempts to replace geometry and precision as follows:

. if all adjacent faces of the edge have surface geometry attached, a
  3-space curve of intersection will be derived by re-intersection of
  these surfaces. Extensive pre-checks will be made to ensure that
  tangent or near-tangent configurations (such as boundaries of
  Variable Radius Blends) are not attempted in this way. In these cases
  the token PK_reset_prec_tangent_c will be returned, and the edge geometry and
  precision will be unchanged. There will also be cases where the edge is not
  a near tangency, but nevertheless a new curve of intersection could not be
  computed (for example, the adjacent surfaces may simply not intersect to
  Parasolid default precision); in such cases PK_reset_prec_failure_c
  will be returned.  If the function is successful, the 'result' will be set
  to PK_reset_prec_ok_c.

. The particular simple case where one of the SP-curves lies within
  Parasolid default precision of the adjacent surface will be dealt
  with by either simplifying this SP-curve to its 3-space equivalent,
  or failing this, by transferring the SP-curve to the edge.

. if not all face geometries are present, as at the boundary of a
  sheet body, the SP-curve present on the relevant fin will be first
  simplified to its 3-space equivalent (if it was a constant parameter
  curve) and this new curve attached to the edge. If no simplification
  was possible, the SP-curve itself will be transferred to the edge.
  In either case PK_reset_prec_ok_c will be returned in 'result' if the
  geometry was successfully recomputed.

If insufficient geometry was present to successfully replace the precision
of the edge, PK_reset_prec_missing_geom_c will be returned.

The function will also attempt to set the precision of each vertex of the edge
to Parasolid default. It will only be able to do this if all the other
edges meeting at the vertex in question have Parasolid default precision
associated with them, and the new 3-space curve intersects at a unique
point with all the other edge curves meeting there.