PK_TOPOL_fctab_error_object_t   

struct PK_TOPOL_fcstr_error_object_s
       {
       PK_facet_fault_t     error;
       int                  object;
       };
typedef struct PK_TOPOL_fcstr_error_object_s
               PK_TOPOL_fcstr_error_object_t;
struct PK_TOPOL_fctab_error_object_s
    {
    PK_TOPOL_fcstr_error_object_t  *data;
    int                             length;
    };
typedef struct PK_TOPOL_fctab_error_object_s
               PK_TOPOL_fctab_error_object_t;

Used in:

PK_TOPOL_facet_table_t


This is a support structure for PK_TOPOL_facet_r_t. It is a lookup table which
'groups' faults detected during facetting with the object for which the fault
occurred.  If the table is returned empty, this denotes that no faults were
found.


first column integer value     second column integer value
---------------------------    ----------------------------

PK_facet_fault_body_c          The specified PK_BODY_t entity could not be
                               facetted using the specified mesh controls due
                               to an invalidity in the body (for example, if
                               the body is not entirely contained within the
                               Parasolid size box).  It implies that no facet
                               mesh has been generated for this body.

PK_facet_fault_face_c          The specified PK_FACE_t entity could not be
                               facetted using the specified mesh controls (for
                               example, if faces on the part being facetted
                               are invalid).  It implies that part of the
                               generated facet mesh is missing.
                               Where possible the application should inform
                               the user that an error has occurred rather than
                               simply ignoring missing faces.

PK_facet_fault_facet_c         The specified facet (whose index is given) is
                               disconnected from some neighbouring facets due
                               to fin-fin matching failing on the face. The
                               topology of the generated facet mesh is valid
                               but may contain superfluous 'slit edges' around
                               the specified facet.
                               This warning is only relevant in cases where an
                               application walks the returned facet mesh.

PK_facet_fault_data_normal_c   The facet function was unable to calculate an
                               accurate surface normal value at the position
                               of the facet data (whose index is given).
                               The vector referenced by this data's
                               'data_normal_idx' table should not be used.

PK_facet_fault_data_param_c    The facet function was unable to calculate
                               accurate parameter values at the position
                               of the facet data (whose index is given).
                               The uv parameter values referenced by this
                               data's 'data_param_idx' table should not be
                               used.

PK_facet_fault_topol_param_c   The facet function was unable to return
                               parameters for the specified body or face.  The
                               uv parameter values referenced by this entity
                               should not be used.

PK_facet_fault_data_deriv_c    The facet function was unable to calculate
                               accurate parameter values at the position
                               of the facet data (whose index is given).
                               The dp and/or the dp2 parameter values
                               referenced by this data's 'data_deriv_idx' table
                               should not be used.

PK_facet_fault_topol_deriv_c   The facet function was unable to return
                               derivatives for the specified body or face.  The
                               dp and/or d2p values referenced by this entity
                               should not be used.

PK_facet_fault_data_curv_c     The facet function was unable to calculate
                               accurate curvatures at the position of the facet
                               data (whose index is given).
                               The curvature values referenced by this data's
                               'data_curv_idx' table should not be used.

PK_facet_fault_thin_face_c     No facets were output for the specified
                               PK_FACE_t entity because the face is very thin.
                               Although a facet may not be output for a given
                               face, this is not an indication that facetting
                               has failed.

PK_facet_fault_mangled_facet_c The facet mesh, in the region of the specified
                               facet (whose index is given), may not satisfy
                               the facetting tolerances, or may be
                               self-intersecting, or is severely creased.

PK_facet_fault_mangled_strip_c The facet mesh, in the region of the specified
                               strip (whose index is given), may not satisfy
                               the facetting tolerances, or may be
                               self-intersecting, or is severely creased.

PK_facet_fault_missing_face_c  The specified PK_FACE_t entity failed to
                               incrementally facet as it did not have a defined
                               facetted perimeter; additional faces need to be
                               facetted.

PK_facet_fault_refinement_c    The specified PK_FACE_t entity cannot be
                               incrementally facetted and satisfy the facetting
                               controls - geometry matching may be lost.

PK_facet_fault_added_missing_c The specified PK_FACE_t entity is required in
                               order to define a facetted perimeter for
                               incremental facetting.

PK_facet_fault_added_refine_c  The specified PK_FACE_t entity needs to be
                               refacetted in order to satisfy the facetting
                               controls due to an adjacent face that is being
                               facetted requiring refinement.

PK_facet_fault_incr_facet_c    The specified PK_FACE_t entity has failed to
                               facet due to an unspecified error during
                               incremental facetting.

PK_facet_fault_pt_off_edge_0_c The facet point associated with the specified
                               point_index lies off the model edge.

PK_facet_fault_pt_off_edge_1_c The facet point associated with the specified
                               point_index lies off the model edge because
                               moving it or a nearby facet point to lie on the
                               model edge would produce a self-intersecting
                               or folded facet.

PK_facet_fault_pt_off_edge_2_c The facet point associated with the specified
                               point_index lies off the model edge because
                               this point lies on a region of the model where
                               the facet topology and model topology are no
                               longer equivalent, typically when a region of
                               the model between two edges is extremely thin.

PK_facet_fault_pt_off_face_c   The facet point associated with the specified
                               point_index lies off the model face that it is
                               associated with.  If parameters are being
                               returned, then the evaluation of those
                               parameters on the associated face's surface will
                               give a different position to the point.