Insert_Sphere

Functions

HC_KEY DInsert_Sphere (const HC_DPOINT *center, double radius, const HC_DVECTOR *axis, const HC_DVECTOR *ortho)
 Similar to Insert_Sphere(), but operates on double-precision data. More...
 
HC_KEY Insert_Sphere (const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)
 Generates a sphere. More...
 

Detailed Description

Function Documentation

◆ DInsert_Sphere()

HC_KEY DInsert_Sphere ( const HC_DPOINT *  center,
double  radius,
const HC_DVECTOR *  axis,
const HC_DVECTOR *  ortho 
)

Similar to Insert_Sphere(), but operates on double-precision data.

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, or -1 if an error occurred.

◆ Insert_Sphere()

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, or -1 if an error occurred.

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.