Insert_Sphere

Functions
void	Insert_Sphere (const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)
HC_KEY	KInsert_Sphere (const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)
void	QInsert_Sphere (const char *segment, const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)
HC_KEY	QKInsert_Sphere (const char *segment, const HC_POINT *center, double radius, const HC_POINT *axis, const HC_POINT *ortho)

---

Function Documentation

void 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.

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.

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

Similar to Insert_Sphere(), but returns an HC_KEY to the object.

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:

key

DETAILS

No additional details. See Insert_Sphere()

NOTES

• If there is an error the KInsert routine will return a-1.

void QInsert_Sphere	(	const char *	segment,
		const HC_POINT *	center,
		double	radius,
		const HC_POINT *	axis,
		const HC_POINT *	ortho
	)

Similar to Insert_Sphere(), but operates on a given segment rather than the currently open one.

Parameters:

	segment	- Segment(s) to be inserted into, if other than the currently- open segment.
	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.

DETAILS

No additional details. See Insert_Sphere()

HC_KEY QKInsert_Sphere	(	const char *	segment,
		const HC_POINT *	center,
		double	radius,
		const HC_POINT *	axis,
		const HC_POINT *	ortho
	)

Similar to Insert_Sphere(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:

	segment	- Segment(s) to be inserted into, if other than the currently- open segment.
	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:

key

DETAILS

No additional details. See Insert_Sphere()

NOTES

• If there is an error the KInsert routine will return a-1.