Insert_Circular_Chord

Functions

HC_KEY DInsert_Circular_Chord (const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
 Similar to Insert_Circular_Chord(), but accepts parameters of type double for increased precision. More...
 
HC_KEY Insert_Circular_Chord (const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
 Generates a polygon describing a portion of a circle. More...
 

Detailed Description

Function Documentation

◆ DInsert_Circular_Chord()

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

Similar to Insert_Circular_Chord(), 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 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

No additional details. See Insert_Circular_Chord().

◆ Insert_Circular_Chord()

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

Generates a polygon describing a portion of a circle.

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.

DETAILS

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.

NOTES

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.

RESTRICTIONS

See also
Insert_Circle, Insert_Circular_Arc, Insert_Circular_Wedge, Insert_Polygon.