PK_FACE_replace_surfs_r_t

struct PK_FACE_replace_surfs_r_s
    {
    PK_local_status_t          status;
    int                        n_error_entities;
    PK_ENTITY_t                *error_entities;
    };
typedef struct PK_FACE_replace_surfs_r_s PK_FACE_replace_surfs_r_t;



This data structure contains the status of the operation and any error
information if a failure is indicated.

Used in:

PK_FACE_replace_surfs_2

Description of fields:



'status'            This status field indicates the overall state of
                    the local operation. Permitted values are :

                       PK_local_status_ok_c
                       PK_local_status_nocheck_c
                       PK_local_status_fail_c
                       PK_local_status_cant_get_pt_c
                       PK_local_status_cant_get_cu_c
                       PK_local_status_cant_get_su_c
                       PK_local_status_cant_offset_c
                       PK_local_status_fa_fail_c
                       PK_local_status_fa_fa_fail_c
                       PK_local_status_ed_remains_c



'n_error_entities' The number of topological or geometric entities in
                   the 'error_entities' array.


'error_entities'   If the 'status' field of this return structure indicates a
                   failure, this array may contain topological or geometric
                   entities which are associated with the failure.


Error entities returned

The 'error_entities' array will contain the following entities according to
the value of the 'status' field :

  PK_local_status_ok_c          : No entities

  PK_local_status_nocheck_c     : No entities

  PK_local_status_cant_get_pt_c : 1 VERTEX   Failed to find new geometry for
                                             existing vertex.
                                  n FACEs    Failed to find geometry for
                                             new vertex.

  PK_local_status_cant_get_cu_c : 1 EDGE     Failed to find new geometry for
                                             existing edge.
                                  n FACEs    Failed to find geometry for
                                             new edge.

  PK_local_status_cant_get_su_c : n FACEs    Unable to produce offset
                                             surfaces for these faces.
                                             No surface replacement is
                                             performed.

  PK_local_status_cant_offset_c : 1 FACE     Failed to offset or face could
                                             not be deleted.

  PK_local_status_fa_fail_c     : 1 FACE     Face which failed check.

  PK_local_status_fa_fa_fail_c  : 2 FACEs    Pair of faces where
                                             inconsistency found.

  PK_local_status_ed_remains_c  : 1 EDGE     An existing edge should have
                                             disappeared
                                  n FACEs    A transient edge should have
                                             disappeared

  PK_local_status_fail_c        : No entities