Brief Index      Full Index      Events Index      I.M. Reference

Insert_Line


Functions

HC_KEY Insert_Line (double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY DInsert_Line (double xa, double ya, double za, double xb, double yb, double zb)

Function Documentation

HC_KEY Insert_Line ( double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Adds a simple line segment to the current graphics segment.

Parameters:
xa - x-coordinate for one end of the line segment.
ya - y-coordinate for one end of the line segment.
za - z-coordinate for one end of the line segment.
xb - x-coordinate for other end of the line segment.
yb - y-coordinate for other end of the line segment.
zb - z-coordinate for other end of the line segment.
Returns:
The key to the inserted geometry, or -1 if an error occurred.

DETAILS

This is a primitive way to insert lines into your scene. More flexible routines include Insert_Polyline(), which requires passing all the x-y-z values at once, and Insert_Ink(), which requires multiple calls to draw a line.

NOTES

If you only work in two dimensions, specify za and zb as zero.

This function's double parameters are internally truncated to float. If you require extra precision, use this function's double-precision variant, DInsert_Line.

RESTRICTIONS

See also:
Insert_Ink, Insert_Polyline, Set_Line_Pattern, Set_Line_Weight, Set_Color, Set_Visibility, Renumber_Key.

HC_KEY DInsert_Line ( double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to Insert_Line(), but accepts parameters of type double for increased precision. Unlike Insert_Line, the parameters are not truncated.

Parameters:
xa - x-coordinate for one end of the line segment.
ya - y-coordinate for one end of the line segment.
za - z-coordinate for one end of the line segment.
xb - x-coordinate for other end of the line segment.
yb - y-coordinate for other end of the line segment.
zb - z-coordinate for other end of the line segment.
Returns:
The key to the inserted geometry.

DETAILS

No additional details. See Insert_Line().

Brief Index      Full Index      Events Index      I.M. Reference