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) |
Returns the three points used to define the circle, as referenced by a key.
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. |
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() ).
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.
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. |
No additional details. See Show_Circle().
Returns the center, radius and normal values used to define the circle, as referenced by a key.
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. |
No additional details.