Brief Index      Full Index      Events Index      I.M. Reference

Show_Ellipse

Functions

void Show_Ellipse (HC_KEY key, HC_POINT *center, HC_POINT *major, HC_POINT *minor)
void DShow_Ellipse (HC_KEY key, HCD_POINT *center, HCD_POINT *major, HCD_POINT *minor)

Function Documentation

void Show_Ellipse ( HC_KEY  key,
HC_POINT *  center,
HC_POINT *  major,
HC_POINT *  minor 
)

Returns the three points used to define the ellipse, as referenced by a key.

Parameters:
key- Unique numeric identifier pointing to an ellipse in the database.
center- An x-y-z triplet for the center used to define the ellipse. (A simple array of three elements may also be used in most languages.) Returned to user. Passed by reference always.
major- An x-y-z triplet defining the major(longest) axis of the ellipse. Returned to user. Passed by reference always.
minor- An x-y-z triplet defining the minor(shortest) axis of the ellipse. Returned to user. Passed by reference always.

DETAILS

This routine finds the three points used to define the ellipse that corresponds to the given key. You could use this ability, for example, to extract data needed to construct a line tangent to an existing ellipse. The key for the ellipse might come from Show_Selection_Element() or Find_Contents() , or it might have been saved by your program when the ellipse was created (via Insert_Ellipse() ).

NOTES

RESTRICTIONS

See also:
Insert_Ellipse, Show_Selection_Element, Get_Selection, Begin_Contents_Search, Compute_Coordinates.
void DShow_Ellipse ( HC_KEY  key,
HCD_POINT *  center,
HCD_POINT *  major,
HCD_POINT *  minor 
)

Similar to Show_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:
key- Unique numeric identifier pointing to an ellipse in the database.
center- An x-y-z triplet for the center used to define the ellipse. (A simple array of three elements may also be used in most languages.) Returned to user. Passed by reference always.
major- An x-y-z triplet defining the major(longest) axis of the ellipse. Returned to user. Passed by reference always.
minor- An x-y-z triplet defining the minor(shortest) axis of the ellipse. Returned to user. Passed by reference always.

DETAILS

No additional details. See Show_Ellipse().

Brief Index      Full Index      Events Index      I.M. Reference