PK_ERROR_code_t      PK_BODY_create_solid_block
(
--- received arguments ---
double               x,         --- block extent in local x direction (>0)
double               y,         --- block extent in local y direction (>0)
double               z,         --- block extent in local z direction (>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 block.


Specific Errors:
    PK_ERROR_distance_le_0          x, y or z <= zero.


In its local coordinate system, this function creates a solid block whose base
is centred at the origin, and whose total length in the directions of the local
axes is x, y and z.

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.