Brief Index      Full Index      I.M. Reference

Insert_Ellipse


Functions

void Insert_Ellipse (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor)
HC_KEY KInsert_Ellipse (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor)
void QInsert_Ellipse (const char *segment, const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor)
HC_KEY QKInsert_Ellipse (const char *segment, const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor)
void DInsert_Ellipse (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor)
HC_KEY DKInsert_Ellipse (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor)
void DQInsert_Ellipse (const char *segment, const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor)
HC_KEY DQKInsert_Ellipse (const char *segment, const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor)

Function Documentation

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

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. The system will automatically take note.

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.

If there is an error the KInsert routine returns a-1.

RESTRICTIONS

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

HC_KEY KInsert_Ellipse ( const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor 
)

Similar to Insert_Ellipse(), but returns an HC_KEY to the 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:
key

DETAILS

No additional details. See Insert_Ellipse()

void QInsert_Ellipse ( const char *  segment,
const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor 
)

Similar to Insert_Ellipse(), 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 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.

DETAILS

No additional details. See Insert_Ellipse()

HC_KEY QKInsert_Ellipse ( const char *  segment,
const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor 
)

Similar to Insert_Ellipse(), 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 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:
key

DETAILS

No additional details. See Insert_Ellipse()

void DInsert_Ellipse ( const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor 
)

Similar to Insert_Ellipse() but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.h.

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.

DETAILS

No additional details. See Insert_Ellipse().

HC_KEY DKInsert_Ellipse ( const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor 
)

Similar to DInsert_Ellipse(), but returns an HC_KEY to the 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:
key

DETAILS

No additional details. See Insert_Ellipse()

void DQInsert_Ellipse ( const char *  segment,
const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor 
)

Similar to DInsert_Ellipse(), 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 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.

DETAILS

No additional details. See Insert_Ellipse()

HC_KEY DQKInsert_Ellipse ( const char *  segment,
const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor 
)

Similar to DInsert_Ellipse(), 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 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:
key

DETAILS

No additional details. See Insert_Ellipse()

Main Index
Brief Index      Full Index      I.M. Functions