HC_Insert_Circular_Chord

Key HC_Insert_Circular_Chord(Point const *point1, Point const *point2, Point const *point3)
Key HC_Insert_Circular_Chord(Point const point1, Point const point2, Point const point3)

Generates a polygon describing a portion of a circle.

A portion of a circle is added to the current segment. The order of the specified points is important. Specifically, the chord begins at the first point, is drawn through the second point and continues through the third point. A line connects the first and third points. The chord is defined as the area bounded by the points.

Circular chords are grouped with ellipses, polygons, shells, and meshes for rendering purposes. The rendition of the interior of the chord can be adjusted with changes to face color and face pattern. The circumference of a chord can be made distinct from the interior through the use of edge color, edge pattern and edge weight. A chord’s visibility and selectability are controlled by the “edge”, “face”, and “polygon” keywords.

If you only work in two dimensions, specify all the z coordinates as zero.

You must make sure that the supplied points are not colinear. The system will issue an error message if all three points lie on a line, or if two points are coincident.

HC_Insert_Circle, HC_Insert_Circular_Arc, HC_Insert_Circular_Wedge, HC_Insert_Polygon.

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