PK_BODY_create_sheet_polygon   


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

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


This function creates a polygonal sheet.


Specific Errors:
    PK_ERROR_distance_le_0          radius <= zero
    PK_ERROR_lt_3_sides             n_sides < 3


In its local coordinate system, this function creates a sheet polygon with
n_sides which is centred at the origin and lies in the xy plane.
The radius is the distance from the origin to each vertex of the polygon,
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.