HC_Insert_Line

Key HC_Insert_Line(double xa, double ya, double za, double xb, double yb, double zb)
Key HC_Insert_Line(double xa, double ya, double za, double xb, double yb, double zb)

Adds a simple line segment to the current graphics segment.

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.

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.

HC_Insert_Ink, HC_Insert_Polyline, HC_Set_Line_Pattern, HC_Set_Line_Weight, HC_Set_Color, HC_Set_Visibility, HC_Renumber_Key.

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.