Brief Index      Full Index      Events Index      I.M. Reference

Edit_Circular_Arc


Functions

void Edit_Circular_Arc (HC_KEY key, const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
void DEdit_Circular_Arc (HC_KEY key, const HC_DPOINT *center, double radius, const HC_DVECTOR *vector)

Function Documentation

void Edit_Circular_Arc ( HC_KEY  key,
const HC_POINT *  point1,
const HC_POINT *  point2,
const HC_POINT *  point3 
)

Modifies a circular arc as it sits in the database.

Parameters:
key - key to a circcular arc.
point1 - An x-y-z triplet for the coordinates of one of three ordered on the circumference of the circle. (A simple of three elements may also be used in most languages.) Passed by reference always.
point2 - As above.
point3 - As above.

DETAILS

A portion of the circumference of a circle is added to the current segment. The order of the specified points is important. Specifically, the arc begins at the first point, is drawn through the second point and continues through the third point.

Circular arcs are grouped with lines, polylines, and elliptical arcs for rendering purposes. The rendition of an arc can be altered through the use of Line Color, Line Weight, and Line Pattern. An arc's Visibility and Selectability can be controlled by the "line" or "polyline" 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 points are coincident.

See also:
Insert_Circular_Arc, Edit_Circle, Insert_Ellipse, Insert_Elliptical_Arc, Insert_Polyline, Set_Visibility, Set_Line_Pattern, Set_Line_Weight, Set_Color, Renumber_Key.

void DEdit_Circular_Arc ( HC_KEY  key,
const HC_DPOINT *  center,
double  radius,
const HC_DVECTOR *  vector 
)

Similar to Edit_Circular_Arc(), but operates on double-precision data.

Parameters:
key - key to a circcular arc.
point1 - An x-y-z triplet for the coordinates of one of three ordered on the circumference of the circle. (A simple of three elements may also be used in most languages.) Passed by reference always.
point2 - As above.
point3 - As above.

Brief Index      Full Index      Events Index      I.M. Reference