 |
PK_TOPOL_find_box |
|
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.
NOTE: This function is deprecated and has been superseded by
PK_TOPOL_find_box_2.
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.