Insert_Circular_Arc

Functions

HC_KEY DInsert_Circular_Arc (const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
 Similar to Insert_Circular_Arc(), but accepts parameters of type double for increased precision. More...
 
HC_KEY Insert_Circular_Arc (const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
 Generates a portion of the circumference of a circle. More...
 

Detailed Description

Function Documentation

◆ DInsert_Circular_Arc()

HC_KEY DInsert_Circular_Arc ( const HCD_POINT *  point1,
const HCD_POINT *  point2,
const HCD_POINT *  point3 
)

Similar to Insert_Circular_Arc(), but accepts parameters of type double for increased precision.

Parameters
point1- An x-y-z triplet for the coordinates of one of three ordered points on the circumference of the circle. A simple array of three double-precision elements may also be used for each parameter. Passed by reference always.
point2- As above.
point3- As above.
Returns
The key to the newly created circular arc, or -1 if an error occurred.

DETAILS

No additional details. See Insert_Circular_Arc().

◆ Insert_Circular_Arc()

HC_KEY Insert_Circular_Arc ( const HC_POINT *  point1,
const HC_POINT *  point2,
const HC_POINT *  point3 
)

Generates a portion of the circumference of a circle.

Parameters
point1- An x-y-z triplet for the coordinates of one of three ordered on the circumference of the circle. A simple array of three elements may also be used for each parameter. Passed by reference always.
point2- As above.
point3- As above.
Returns
The key to the inserted geometry, or -1 if an error occurred.

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.

Make sure the points are not colinear. The system issues an error message if all three points lie on a line, or if two points are coincident.

Zooming in close on very large circular arcs results in a linear appearance.

See also
Insert_Circle, Insert_Ellipse, Insert_Elliptical_Arc, Insert_Polyline.