PK_ERROR_code_t      PK_BODY_create_solid_sphere
(
--- received arguments ---
double               radius,    --- sphere radius (>0)
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 sphere.


Specific Errors:
    PK_ERROR_distance_le_0          radius <= zero


In its local coordinate system, this function creates a solid sphere of the
given radius centred at the origin.

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.

The basis_set in the standard forms of the created SPHERE surface inherits the
axis and ref_direction from the given basis_set.