PK_SURF_find_box

PK_ERROR_code_t             PK_SURF_find_box
(
--- received arguments ---
PK_SURF_t                   surface,        --- surface to be boxed
const PK_SURF_find_box_o_t *options,        --- options structure

--- returned arguments ---
PK_BOX_t             *const surface_box     --- box containing full surface,
                                            --- or surface bounded by 'uvbox'
)


This function returns a BOX which bounds the given surface.
The application can provide a UVBOX to limit the surface to be boxed. If the
surface is infinite in any direction, the application must provide a uvbox.


Specific Errors:
    PK_ERROR_invalid_geometry       the input surface is invalid. (MILD)
    PK_ERROR_bad_combination        a 'uvbox' has been provided for a mesh.
                                    (MILD)
    PK_ERROR_unsuitable_entity      the input surface is infinite in at least
                                    one direction, and the application has not
                                    provided a 'uvbox'. (MILD)
    PK_ERROR_bad_uvbox              the input 'uvbox' is invalid on 'surface'.
                                    (MILD)