PK_ERROR_code_t  PK_CONE_make_solid_body
(
--- received arguments ---
PK_CONE_t        cone,      --- conical surface
PK_INTERVAL_t    range,     --- extent of conical solid along its axis

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


This function creates a solid body from a conical surface.


Specific Errors:
    PK_ERROR_zero_interval         the range has no extent
    PK_ERROR_bad_interval          the range goes outside the size box or
                                   it spans the apex of the cone


The range defines the part of the cone axis which will be inside the conical
solid.  The range is measured in the direction of the cone axis with zero at
the location in the basis_set of the cone's standard form.  At either end of
this part of the axis, the solid will be bounded by a plane at right angles to
the cone axis.  As a special case, the cone apex may be exactly at one end of
the range, in which case the solid becomes bounded by a vertex at the apex
rather than a plane.

If the cone is an orphan, it will become the surface of a face of the created
body.  If the cone is not an orphan, then a copy of it will be made and this
used to create the solid.

The basis_set in the standard forms of circles created for edge geometry
inherits the ref_direction from the basis_set in the standard form of the
given cone.