struct PK_TOPOL_facet_r_s
    {
    int number_of_facets;
    int number_of_fins;
    int number_of_vertices;
    PK_TOPOL_fctab_facet_fin_t      facet_fin;
    PK_TOPOL_fctab_fin_fin_t        fin_fin;
    PK_TOPOL_fctab_fin_vertex_t     fin_vertex;
    PK_TOPOL_fctab_vertex_point_t   vertex_point;
    PK_TOPOL_fctab_vertex_normal_t  vertex_normal;
    PK_TOPOL_fctab_vertex_param_t   vertex_param;
    PK_TOPOL_fctab_point_vec_t      point_vec;
    PK_TOPOL_fctab_normal_vec_t     normal_vec;
    PK_TOPOL_fctab_param_uv_t       param_uv;
    PK_TOPOL_fctab_param_dp_t       param_dp;
    PK_TOPOL_fctab_param_d2p_t      param_d2p;
    PK_TOPOL_fctab_facet_face_t     facet_face;
    PK_TOPOL_fctab_facet_occ_t      facet_occ;
    PK_TOPOL_fctab_edge_fin_t       edge_fin;
    PK_TOPOL_fctab_edge_occ_t       edge_occ;
    PK_TOPOL_fctab_error_facet_t    error_facet;
    };
typedef struct PK_TOPOL_facet_r_s PK_TOPOL_facet_r_t;



The PK_TOPOL_facet_r_t structure returns the total number of facets, fins and
vertices in the facet mesh, with tables representing facet topology, geometry,
associative and error data as requested in the PK_TOPOL_facet_choice_o_t
options structure.


The returned structure always calculates and returns the number of facets,
fins and vertices in the facet mesh, irrespective of choices selected by
the PK_TOPOL_facet_choice_o_t options structure.

Each table is named in the form  PK_TOPOL_fctab_<table>_t <table>
    where each "<table>" field name corresponds to one of the
    PK_LOGICAL_t switch names in PK_TOPOL_facet_choice_o_t

If a specific table was requested (by setting the corresponding field name
in PK_TOPOL_facet_choice_o_t to PK_LOGICAL_true), the table is returned with :

  -  an array pointer
  -  an integer which contains the number of array items

The array pointer is an address in virtual memory, provided by the memory
allocator (as registered with PK_MEMORY_register_callbacks). All such virtual
memory data must be freed by the application.

If a table was not requested, the table is returned with :
  -  an array pointer which contains NULL
  -  an integer length of zero

To free all of the memory allocated for the return tables, the function
PK_TOPOL_facet_r_f should be called.