PK_MESH_create_from_facets

PK_ERROR_code_t                       PK_MESH_create_from_facets
(
--- received arguments ---
PK_MESH_facet_cb_f_t                  facet_reader, --- callback to read
                                                    --- sequential facet data
const PK_POINTER_t                    context,      --- data returned to reader
                                                    --- in 'facet_reader'
const PK_MESH_create_from_facets_o_t *options,      --- options structure

--- returned arguments ---
PK_MESH_t                      *const mesh          --- created mesh
)





Specific Errors:
    PK_ERROR_mesh_not_created           The 'create' option was set to
                                        PK_MESH_create_later_c, but there was
                                        a failure when the 'facet_reader' was
                                        called. (SEVERE)
    PK_ERROR_index_out_of_range         Vertex index is out of range. (MILD)
    PK_ERROR_facet_invalid_input        Position or normal is not a valid
                                        vector. (MILD)
    PK_ERROR_mesh_has_no_mfacets        Mesh has no valid facets (MILD).
    PK_ERROR_inconsistent_data          Some facet blocks include normals
                                        while others do not. (MILD)
    PK_ERROR_callback_failed            The application's  'facet_reader'
                                        callback function has returned
                                        PK_MESH_cb_status_fail_c. (MILD)
    PK_ERROR_bad_mesh_box               The box supplied by the application
                                        is not big enough. (MILD)


This function creates a mesh from data obtained by sequentially calling
the input function 'facet_reader' until it returns PK_MESH_cb_status_stop_c.

See here for more information.