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.