PK_ERROR_code_t PK_TOPOL_find_box
(
--- received arguments ---
PK_TOPOL_t      topol,       --- entity for which a box is required

--- returned arguments ---
PK_BOX_t *const box          --- box containing entity
)


This function returns a BOX which bounds the given topological entity.


Specific Errors:
    PK_ERROR_empty_body         body has no faces, edges or vertices
    PK_ERROR_empty_assy         assembly instances no bodies
    PK_ERROR_missing_geom       entity has missing vertex geometry
    PK_ERROR_wrong_entity       entity is of incorrect type


The topological entity must be an assembly, body, face or edge.

The returned box will contain the given entity and it will usually be close
to the minimum bounding box but this is not guaranteed.

If any face or edge geometry is missing, the box will still be calculated
ignoring such faces and edges.  If any vertex geometry is missing then
the function will fail.

An attempt to box an empty body will fail.