Brief Index      Full Index      Events Index      I.M. Reference

Insert_Ellipse

Functions

HC_KEY Insert_Ellipse (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor)
 
HC_KEY DInsert_Ellipse (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor)
 

Detailed Description

Function Documentation

HC_KEY Insert_Ellipse ( const HC_POINT center,
const HC_POINT major,
const HC_POINT minor 
)

Generates a flat, infinitely thin, colored-in elliptical object.

Parameters
center- An x-y-z triplet for the coordinates of the center of the ellipse. (A simple array of three elements may also be used in most languages.) Passed by reference always.
major- An x-y-z triplet for the coordinates of the intersection of the ellipse and its major axis. Passed by reference always.
minor- An x-y-z triplet for the coordinates of the intersection of the ellipse and its minor axis. Passed by reference always.
Returns
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

A closed, flat, colored-in ellipse is added to the current segment.

Ellipses are grouped with circles, polygons, shells, and meshes for rendering purposes. The rendition of the interior of the ellipse can be adjusted with changes to face color and face pattern. The circumference of an ellipse can be made distinct from the interior through the use of edge color, edge pattern and edge weight. An ellipse's visibility and selectability are controlled by the "edge", "face", and "polygon" keywords.

NOTES

If you only work in two dimensions, specify all the z coordinates as zero.

Make sure the points are not colinear. The system checks and issues an error message if all three points lie on a line, or if two are coincident.

RESTRICTIONS

See Also
Insert_Circle, Insert_Circular_Arc, Insert_Elliptical_Arc, Insert_Polygon, .
HC_KEY DInsert_Ellipse ( const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor 
)

Similar to Insert_Ellipse(), but accepts parameters of type double for increased precision.

Parameters
center- An x-y-z triplet for the coordinates of the center of the ellipse. (A simple array of three elements may also be used in most languages.) Passed by reference always.
major- An x-y-z triplet for the coordinates of the intersection of the ellipse and its major axis. Passed by reference always.
minor- An x-y-z triplet for the coordinates of the intersection of the ellipse and its minor axis. Passed by reference always.
Returns
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

No additional details. See Insert_Ellipse().

Brief Index      Full Index      Events Index      I.M. Reference