Brief Index      Full Index      I.M. Reference

Insert_Circular_Arc


Functions

void Insert_Circular_Arc (const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
HC_KEY KInsert_Circular_Arc (const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
void QInsert_Circular_Arc (const char *segment, const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
HC_KEY QKInsert_Circular_Arc (const char *segment, const HC_POINT *point1, const HC_POINT *point2, const HC_POINT *point3)
void DInsert_Circular_Arc (const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
HC_KEY DKInsert_Circular_Arc (const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
void DQInsert_Circular_Arc (const char *segment, const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)
HC_KEY DQKInsert_Circular_Arc (const char *segment, const HCD_POINT *point1, const HCD_POINT *point2, const HCD_POINT *point3)

Function Documentation

void Insert_Circular_Arc ( const HC_POINT *  point1,
const HC_POINT *  point2,
const HC_POINT *  point3 
)

Generates a portion of the circumference 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.

DETAILS

A portion of the circumference of a circle is added to the current segment. The order of the specified points is important. Specifically, the arc begins at the first point, is drawn through the second point and continues through the third point.

Circular arcs are grouped with lines, polylines, and elliptical arcs for rendering purposes. The rendition of an arc can be altered through the use of Line Color, Line Weight, and Line Pattern. An arc'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 will return a-1.

RESTRICTIONS

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

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

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

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

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

DETAILS

No additional details. See Insert_Circular_Arc()

void QInsert_Circular_Arc ( const char *  segment,
const HC_POINT *  point1,
const HC_POINT *  point2,
const HC_POINT *  point3 
)

Similar to Insert_Circular_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.
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.

DETAILS

No additional details. See Insert_Circular_Arc()

HC_KEY QKInsert_Circular_Arc ( const char *  segment,
const HC_POINT *  point1,
const HC_POINT *  point2,
const HC_POINT *  point3 
)

Similar to Insert_Circular_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.
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:
key

DETAILS

No additional details. See Insert_Circular_Arc()

void DInsert_Circular_Arc ( const HCD_POINT *  point1,
const HCD_POINT *  point2,
const HCD_POINT *  point3 
)

Similar to Insert_Circular_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:
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.

DETAILS

No additional details. See Insert_Circular_Arc().

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

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

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

DETAILS

No additional details. See Insert_Circular_Arc()

void DQInsert_Circular_Arc ( const char *  segment,
const HCD_POINT *  point1,
const HCD_POINT *  point2,
const HCD_POINT *  point3 
)

Similar to DInsert_Circular_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.
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.

DETAILS

No additional details. See Insert_Circular_Arc()

HC_KEY DQKInsert_Circular_Arc ( const char *  segment,
const HCD_POINT *  point1,
const HCD_POINT *  point2,
const HCD_POINT *  point3 
)

Similar to DInsert_Circular_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.
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:
key

DETAILS

No additional details. See Insert_Circular_Arc()

Main Index
Brief Index      Full Index      I.M. Functions