 |
PK_SURF_make_sheet_body |
|
PK_ERROR_code_t PK_SURF_make_sheet_body
(
--- received arguments ---
PK_SURF_t surf, --- surf
PK_UVBOX_t uv_box, --- extent of surf
--- returned arguments ---
PK_BODY_t *const body --- sheet body returned
)
This function creates a sheet body from a surface.
This function does not support facet geometry [NF]
Specific Errors:
PK_ERROR_unsuitable_entity cannot make sheet body from surface of this
class
PK_ERROR_bad_uvbox uvbox is invalid on this surface
PK_ERROR_invalid_geometry surface fails to pass checks
PK_ERROR_bad_shared_dep dependent of entity would be illegally
shared
PK_ERROR_non_manifold resulting body would be non-manifold
PK_ERROR_cant_extract_geom failed to extract geometry
The part of the surface required must be defined by 'uv_box'.
The sheet may be closed. If the sheet body crosses the seam of a closed
surface, then the parameterisation of the surface across the seam must be
periodic.
If the surface is an orphan, then it will be used as the geometry of the
body, otherwise a copy of it will be used as the geometry of the body.
The agreement of the surface orientation and the sheet's face orientation
depends on how the sheet body is made; PK_FACE_ask_oriented_surf should
be used to obtain the orientation of the resultant face with respect to
the given surface.