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)
 

Detailed Description

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