Insert_Line

Functions

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

Detailed Description

Function Documentation

◆ DInsert_Line()

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().

◆ Insert_Line()

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.