Insert_Elliptical_Arc

Functions

HC_KEY DInsert_Elliptical_Arc (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor, double start, double end)
 Similar to Insert_Elliptical_Arc(), but accepts parameters of type double for increased precision. More...
 
HC_KEY Insert_Elliptical_Arc (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor, double start, double end)
 Generates a portion of the perimeter of an ellipse. More...
 

Detailed Description

Function Documentation

◆ DInsert_Elliptical_Arc()

HC_KEY DInsert_Elliptical_Arc ( const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor,
double  start,
double  end 
)

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

Parameters
center- An x-y-z triplet for the coordinates of the center of an ellipse. (A simple array of three elements may also be used in most languages.) Passed by reference always.
major- An x-y-z triplet for the coordinates of the intersection of the ellipse and its major axis. Passed by reference always.
minor- An x-y-z triplet for the coordinates of the intersection of the ellipse and its minor axis. Passed by reference always.
start- The normalized parametric angle along the ellipse's perimeter, in the direction from the major to minor axis, where the arc starts.
end- The normalized parametric angle along the perimeter, in the direction from the major to minor axis, where the arc ends.
Returns
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

No additional details. See Insert_Elliptical_Arc().

◆ Insert_Elliptical_Arc()

HC_KEY Insert_Elliptical_Arc ( const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor,
double  start,
double  end 
)

Generates a portion of the perimeter of an ellipse.

Parameters
center- An x-y-z triplet for the coordinates of the center of an ellipse. (A simple array of three elements may also be used in most languages.) Passed by reference always.
major- An x-y-z triplet for the coordinates of the intersection of the ellipse and its major axis. Passed by reference always.
minor- An x-y-z triplet for the coordinates of the intersection of the ellipse and its minor axis. Passed by reference always.
start- The normalized parametric angle along the ellipse's perimeter, in the direction from the major to minor axis, where the arc starts.
end- The normalized parametric angle along the perimeter, in the direction from the major to minor axis, where the arc ends.
Returns
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

A portion of the perimeter of an ellipse is added to the current segment.

The direction of the perimeter is determined by the shortest path between the points used to define the major and minor axes. The starting and ending points are the parametric angular distances, specified between 0.0 and 1.0, along the perimeter. For example, a quarter of an ellipse could be specified with start and end points of 0.25 and 0.5, respectively.

Elliptical arcs are grouped with lines, polylines, and circular arcs for rendering purposes. The rendition of an arc can be altered through the use of line color, line weight and line pattern. An ellipse'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. The system will automatically take note.

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

Zooming in close on very large elliptical arcs results in a flat appearance.

See also
Insert_Ellipse, Insert_Circle, Insert_Circular_Arc, Insert_Polyline.