PK_EDGE_set_precision_2

PK_ERROR_code_t PK_EDGE_set_precision_2
(
--- received arguments ---
PK_EDGE_t                        edge,        --- edge
double                           precision,   --- required precision
const PK_EDGE_set_precision_o_t *options,     --- options

--- returned arguments ---
int                       *const n_new_edges, --- number of new edges
PK_EDGE_t                **const new_edges    --- new edges
)


This function sets the 'precision' of the given 'edge'.

This function offers partial support for facet geometry [PF]


Specific Errors:
    PK_ERROR_general_body          generalised topology not enabled (MILD)
    PK_ERROR_missing_geom          the adjacent faces have no surfaces (MILD)
    PK_ERROR_facet_geometry        the edge is accurate and every adjacent
                                   face has facet geometry attached (MILD)
    PK_ERROR_bad_tolerance         either the edge is too short or the
                                   tolerance is too small (MILD/SERIOUS)
    PK_ERROR_failed_to_create_sp   SP-curve generator failed for unknown
                                   reason (MILD)
    PK_ERROR_tolerances_too_tight  SP-curve generator could not achieve
                                   tolerance (MILD/SERIOUS)
    PK_ERROR_edge_too_short        the edge or one of its neighbours is too
                                   short (MILD)


The action of this function depends on whether the 'edge' previously had no
geometry attached,  the 'edge' previously had a non-default precision
associated with it or the 'edge' previously did not have a precision
associated with it (i.e. whether Parasolid regarded the edge as "exact").

The action for an edge with no geometry attached is as follows:

An edge with no geometry attached to it or any fin has special behaviour.  On
such an edge, if 'precision' is greater than half times session precision, then
the precision of the edge will become 'precision' and the application will have
the ability to attach SP-curves to its fins.  If 'precision' is less than or
equal to half times session precision, then the edge will be made accurate and
the application will lose the ability to attach SP-curves to the fins.  The
edge may belong to a general body.


The action for an exact edge is as follows:

The 3-space edge curve is used to create SP-curves on the adjacent
surfaces, which are subsequently attached to the fins of the edge.
The precision of the edge is to be viewed as a band of uncertainty within
which all defining SP-curves lie.
There will always be the following side-effects:
. The original 3-space curve will be detached and deleted if possible, unless
  the edge's body has nominal geometry enabled, in which case the edge's curve
  will be retained as nominal geometry.
. The precisions of all vertices on the edge will be increased if
  necessary so as to be greater than or at least equal to 'precision'.
  The point on the vertex will be recomputed.
. It will be impossible to make the edge "exact" again by using
  PK_EDGE_set_precision_2. Once this routine has been used on an edge,
  it will continue to be represented geometrically by means of SP-curves
  attached to the fins unless PK_EDGE_reset_precision is called.
Additionally, the following may occur:
. It may not always be possible to compute one SP-curve from the
  original curve and the relevant face surface. This will be due
  to G1 discontinuities (in the surface parameter space) which will
  have to be represented as extra vertices. The edge may therefore
  be split a number of times, once for every surface singularity or
  discontinuity which lay on the original curve. Any new edges created
  by this process will be returned to the application in 'new_edges'.

It is an error if the edge is shorter than twice the given 'precision'.

The action for an edge already possessing a precision is as follows:

The SP-curve(s) already present on the fins of the edge will be
unchanged. The precision of the edge will be set to 'precision'.
The precisions of vertices of the edge will be increased if
necessary so as to be greater than or at least equal to the supplied
precision. It should be noted that reducing the precision value on
an already inexact edge is not recommended, as the existing
SP-curve(s) will not be replaced in this case. Hence such an edge
may fail checking.


If the edge belongs to a general body and generalised topology is not enabled
(see PK function PK_SESSION_set_general_topology) the error
PK_ERROR_general_body will be returned.

If all of the faces of the edge are rubber, the error PK_ERROR_missing_geom is
returned. If all of the faces of the edge have facet geometry attached and
the edge is accurate, the error PK_ERROR_facet_geometry is returned.