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.


Specific Errors:
    PK_ERROR_general_body          general body
    PK_ERROR_bad_tolerance         precision is too small


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.
  . attempting to set a precision on a vertex without a point
    attached will result in an error.

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.

This function is not supported for entities which are part of a
general body.