Brief Index      Full Index      I.M. Reference

Insert_Elliptical_Arc


Functions

void Insert_Elliptical_Arc (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor, double start, double end)
HC_KEY KInsert_Elliptical_Arc (const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor, double start, double end)
void QInsert_Elliptical_Arc (const char *segment, const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor, double start, double end)
HC_KEY QKInsert_Elliptical_Arc (const char *segment, const HC_POINT *center, const HC_POINT *major, const HC_POINT *minor, double start, double end)
void DInsert_Elliptical_Arc (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor, double start, double end)
HC_KEY DKInsert_Elliptical_Arc (const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor, double start, double end)
void DQInsert_Elliptical_Arc (const char *segment, const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor, double start, double end)
HC_KEY DQKInsert_Elliptical_Arc (const char *segment, const HCD_POINT *center, const HCD_POINT *major, const HCD_POINT *minor, double start, double end)

Function Documentation

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

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.

If there is an error the KInsert routine returns a-1.

RESTRICTIONS

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

See also:
Insert_Ellipse, Insert_Circle, Insert_Circular_Arc, Insert_Polyline, Set_Line_Pattern, Set_Line_Weight, Set_Color, Renumber_Key.

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

Similar to Insert_Elliptical_Arc(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Elliptical_Arc()

void QInsert_Elliptical_Arc ( const char *  segment,
const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor,
double  start,
double  end 
)

Similar to Insert_Elliptical_Arc(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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.

DETAILS

No additional details. See Insert_Elliptical_Arc()

HC_KEY QKInsert_Elliptical_Arc ( const char *  segment,
const HC_POINT *  center,
const HC_POINT *  major,
const HC_POINT *  minor,
double  start,
double  end 
)

Similar to Insert_Elliptical_Arc(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

DETAILS

No additional details. See Insert_Elliptical_Arc()

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

DETAILS

No additional details. See Insert_Elliptical_Arc().

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

Similar to DInsert_Elliptical_Arc(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Elliptical_Arc()

void DQInsert_Elliptical_Arc ( const char *  segment,
const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor,
double  start,
double  end 
)

Similar to DInsert_Elliptical_Arc(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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.

DETAILS

No additional details. See Insert_Elliptical_Arc()

HC_KEY DQKInsert_Elliptical_Arc ( const char *  segment,
const HCD_POINT *  center,
const HCD_POINT *  major,
const HCD_POINT *  minor,
double  start,
double  end 
)

Similar to DInsert_Elliptical_Arc(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

DETAILS

No additional details. See Insert_Elliptical_Arc()

Main Index
Brief Index      Full Index      I.M. Functions