PK_PARTITION_ask_facet_geom

PK_ERROR_code_t                        PK_PARTITION_ask_facet_geom
(
--- received arguments ---
PK_PARTITION_t                         partition,          --- partition
const PK_PARTITION_ask_facet_geom_o_t *options,            --- option structure

--- returned arguments ---
PK_GEOM_category_t              *const partition_category, --- categorisation
                                                           --- of the geometry
                                                           --- in the partition
int                             *const n_parts,            --- number of parts
                                                           --- with facet
                                                           --- geometry
PK_PART_t                      **const parts,              --- parts with
                                                           --- facet geometry
PK_GEOM_category_t             **const part_categories,    --- categorisation
                                                           --- of the geometry
                                                           --- of the parts
int                             *const n_geoms,            --- number of facet
                                                           --- orphan
                                                           --- geometries
PK_GEOM_t                      **const geoms               --- facet orphan
                                                           --- geometries
)


This function categorises the parts and geometry of a partition and optionally
returns any parts that contain facet geometry, as well as any facet orphan
geometry. The only possible categorisations for returned parts and geometries
are PK_GEOM_category_mixed_c and PK_GEOM_category_facet_c.


The function will only categorise the parts and orphan geometry currently alive
in the partition. It will not examine any of the deltas associated with the
partition.