PK_VERTEX_set_precision

PK_ERROR_code_t PK_VERTEX_set_precision
(
--- received arguments ---
PK_VERTEX_t     vertex,      --- vertex
double          precision    --- required precision

--- returned arguments ---
)


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

This function offers partial support for facet geometry [PF]


Specific Errors:
    PK_ERROR_bad_tolerance  (MILD) precision is too small or too large
    PK_ERROR_facet_geometry (MILD) the vertex is accurate and every
                                   adjacent edge has facet geometry
                                   attached


The precision of a vertex is to be viewed as the radius of a sphere
of uncertainty around the point of the vertex. Setting the precision
value is subject to the following restrictions:
  . it is not permitted to set the precision of a vertex to less than
    the maximum of the precisions of the edges meeting at it.
  . it is not permitted to set the precision of a vertex so that any of
    the edges of the vertex lie completely within the sphere of uncertainty.

Note that setting precisions on edges and vertices risks rendering
the model invalid, as these precision values will be used for
determining whether geometric items meet appropriately or not. For example,
slackening the precision of a particular vertex may result in its clashing
with a nearby edge, or interfering with another vertex. Both of
these configurations will be recognised by checking. Some checks are made for
local effects of this nature but such checking is by no means exhaustive.