Brief Index      Full Index      Events Index      I.M. Reference

Insert_Circular_Wedge

Functions

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

Function Documentation

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 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.
Returns:
The key to the inserted geometry.

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. The system will automatically take note.

You must make sure that 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.

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.

If there is an error the Insert routine will return a-1.

RESTRICTIONS

See also:
Insert_Circle, Insert_Circular_Arc, Insert_Circular_Chord, Insert_Polygon, Set_Visibility, Set_Edge_Pattern, Set_Edge_Weight, Set_Face_Pattern, Set_Color, Renumber_Key, Set_Circular_Center.
HC_KEY DInsert_Circular_Wedge ( const HCD_POINT *  point1,
const HCD_POINT *  point2,
const HCD_POINT *  point3 
)

Similar to Insert_Circular_Wedge but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.h.

Parameters:
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.
Returns:
The key to the inserted geometry.

DETAILS

No additional details. See Insert_Circular_Wedge().

Brief Index      Full Index      Events Index      I.M. Reference