Functions
Show_Circle

Functions

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. More...
 
void DShow_Circle (HC_KEY key, HCD_POINT *point1, HCD_POINT *point2, HCD_POINT *point3)
 Similar to Show_Circle(), but returns double-precision values. More...
 
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. More...
 
void DShow_Circle_By_Radius (HC_KEY key, HC_DPOINT *center, double *radius, HC_DVECTOR *normal)
 Similar to Show_Circle_By_Radius, but returns double-precision values. More...
 

Detailed Description

Function Documentation

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

Similar to Show_Circle(), but returns double-precision values.

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 DShow_Circle_By_Radius ( HC_KEY  key,
HC_DPOINT *  center,
double *  radius,
HC_DVECTOR *  normal 
)

Similar to Show_Circle_By_Radius, but returns double-precision values.

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