PK_ERROR_code_t      PK_BODY_create_solid_prism
(
--- received arguments ---
double               radius,    --- prism radius (>0)
double               height,    --- prism height (>0)
int                  n_sides,   --- number of sides (>2)
const PK_AXIS2_sf_t *basis_set, --- position and orientation (may be NULL)

--- returned arguments ---
PK_BODY_t     *const body       --- solid body returned
)


This function creates a solid prism.


Specific Errors:
    PK_ERROR_distance_le_0          radius or 'height' <= zero
    PK_ERROR_lt_3_sides             'n_sides' < 3


In its local coordinate system, this function creates a solid prism with
n_sides whose base is centred at the origin and lies in the xy plane,
and which extends to the given height along the z axis.  The radius is
the distance from the origin to each vertex of the base, one of which lies on
the x axis.

basis_set positions and orientates the local coordinate system in the world
coordinate system.  If it is given as NULL, then the local and world
coordinate systems are the same.