Insert_Circular_Wedge

Functions

HC_KEY DInsert_Circular_Wedge (const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
 Similar to Insert_Circular_Wedge, but accepts parameters of type double for increased precision. More...
 
HC_KEY Insert_Circular_Wedge (const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
 Generates a wedge shaped polygon representing a portion of a circle. More...
 

Detailed Description

Function Documentation

◆ DInsert_Circular_Wedge()

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

Similar to Insert_Circular_Wedge, but accepts parameters of type double for increased precision.

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

No additional details. See Insert_Circular_Wedge().

◆ Insert_Circular_Wedge()

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

Generates a wedge shaped polygon representing a portion of a circle.

Parameters
point1- An x-y-z triplet for the coordinates of one of three ordered points on the rounded portion of the wedge. 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 wedge begins at the first point, is drawn through the second point and continues through the third point. The center of a circle defined by the 3 points is computed. Lines are drawn from the first point to the center and from the third point to the center. The wedge is defined as the area bounded by the points.

Circular wedges are grouped with ellipses, polygons, shells and meshes for rendering purposes. The rendition of the interior of the wedge can be adjusted with changes to Face Color and Face Pattern. The circumference of a wedge 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 points are not colinear. The system issues an error message if all three points lie on a line, or if two points are coincident.

Because of the way the center of a wedge is computed, it may be expedient to explicitly set the circular center via Set_Circular_Center(). This will help prevent rounding errors, especially in cases where the arc is very small.

RESTRICTIONS

See also
Insert_Circle, Insert_Circular_Arc, Insert_Circular_Chord, Insert_Polygon, Set_Circular_Center.