Brief Index      Full Index      Events Index      I.M. Reference

Insert_Sphere

Functions

HC_KEY Insert_Sphere (const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)

Function Documentation

HC_KEY Insert_Sphere ( const HC_POINT *  center,
double  radius,
const HC_POINT *  axis,
const HC_POINT *  ortho 
)

Generates a sphere.

Parameters:
center- An x-y-z triplet for the coordinates of center the sphere. (A simple array of three elements may also be used in most languages.) Passed by reference always.
radius- Length of the radius of the sphere.
axis- Vector that points in the longtitudal/vertical direction. If null then a default value of <0,10,0> is applied.
ortho- Vector that points in the latitudal/horizontal direction. If null then a default value of <1,0,0> is applied.
Returns:
The key to the inserted geometry.

DETAILS

The sphere primitive is tesselated at draw time which can greatly reduce the memory footprint of an application in which spheres are widely used. The tesselation of the sphere is controlled by the "sphere" option within the "tesselation" Rendering_Option.

See also:
Insert_Circle, Insert_Ellipse, Insert_Circular_Arc, Insert_Circular_Chord, Insert_Circular_Wedge, Insert_Elliptical_Arc, Insert_Polygon, Set_Visibility, Set_Edge_Pattern, Set_Edge_Weight, Set_Face_Pattern, Set_Color, Renumber_Key.

Brief Index      Full Index      Events Index      I.M. Reference