PK_FACE_attach_surf_fitting

PK_ERROR_code_t         PK_FACE_attach_surf_fitting
(
--- received arguments ---
PK_FACE_t               face,                --- face
PK_LOGICAL_t            local_check,         --- whether to perform local check

--- returned arguments ---
PK_local_check_t *const local_check_result   --- result of local check
)


This function creates a surface to fit and attach to face.

This function does not support facet geometry [NF]


Specific Errors:
    PK_ERROR_general_body           'face' comes from general body
    PK_ERROR_unsuitable_entity      'face' does not comes from a sheet
                                    or solid body
    PK_ERROR_cant_find_su           Unable to find surface


If possible, a surface is created, consistent with the edge geometry of the
face, which replaces the existing surface geometry (typically rubber).

If a simple surface (plane, cylinder, torus, cone or sphere) will fit,
it will be used; if no simple surface will fit, the modeller may be able to
fit another surface (such as a blend or B-surface) but this is not
guaranteed. It may be that more than one surface will fit the edges. In this
case it is not defined which surface will be used.

In general this procedure may give rise to self-intersecting object
boundaries which could cause unpredictable errors later.

If local checking is on, consistency checks will be
made on newly created topological and geometrical entities, and the
result of the local check on the body returned.

A result of PK_local_check_ok_c       indicates the body is valid.
A result of PK_local_check_negated_c  indicates that the result body
                                      was originally "inside out" but has
                                      been negated, and is now "positive"
                                      (has positive volume) and valid.
A result of PK_local_check_failed_c   indicates the body is self-intersecting
                                      and further modelling operations on it
                                      may fail. It is the responsibility
                                      of the calling routine to make any
                                      necessary reparation.

A result of PK_local_check_no_c       indicates that local checking is
                                      switched off.

A self-intersecting body can be returned.

This function should only be called for faces in sheet or solid bodies. It is
not supported for general bodies.

See Attaching a surface to a face for more information.