Brief Index      Full Index      Events Index      I.M. Reference

Show_Circle


Functions

void Show_Circle (HC_KEY key, HC_POINT *point1, HC_POINT *point2, HC_POINT *point3)
void DShow_Circle (HC_KEY key, HCD_POINT *point1, HCD_POINT *point2, HCD_POINT *point3)
void Show_Circle_By_Radius (HC_KEY key, HC_POINT *center, float *radius, HC_VECTOR *normal)

Function Documentation

void Show_Circle ( HC_KEY  key,
HC_POINT *  point1,
HC_POINT *  point2,
HC_POINT *  point3 
)

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

Parameters:
key - Unique numeric identifier pointing to a circle in the database.
point1 - One of three points on the circumference of the circle. (A simple array of three elements may also be used in most languages.) Returned to user. Passed by reference always
point2 - As Above.
point3 - As Above.

DETAILS

This routine finds the three points used to define the circle 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 circle. The key for the circle might come from Show_Selection_Element() or Find_Contents() , or it might have been saved by your program when the circle was created (via Insert_Circle() ).

NOTES

RESTRICTIONS

See also:
Insert_Circle, Show_Selection_Element, Get_Selection, Begin_Contents_Search, Compute_Coordinates.

void DShow_Circle ( HC_KEY  key,
HCD_POINT *  point1,
HCD_POINT *  point2,
HCD_POINT *  point3 
)

Similar to Show_Circle(), 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 a circle in the database.
point1 - One of three points on the circumference of the circle. (A simple array of three elements may also be used in most languages.) Returned to user. Passed by reference always
point2 - As Above.
point3 - As Above.

DETAILS

No additional details. See Show_Circle().

void Show_Circle_By_Radius ( HC_KEY  key,
HC_POINT *  center,
float *  radius,
HC_VECTOR *  normal 
)

Returns the center, radius and normal values used to define the circle, as referenced by a key.

Parameters:
key - Unique numeric identifier pointing to a circle in the database.
center - An x-y-z triplet for the coordinates of center the circle. (A simple array of three elements may also be used in most languages.) Returned to user. Passed by reference always.
radius - Length of the radius of the circle. Returned to user.
normal - Vector that is perpendicular to the plane of the circle. Returned to user.

DETAILS

No additional details.

See also:
Insert_Circle, Show_Selection_Element, Get_Selection, Begin_Contents_Search, Compute_Coordinates.

Brief Index      Full Index      Events Index      I.M. Reference