Brief Index      Full Index      Events Index      I.M. Reference

Insert_Infinite_Line


Functions

HC_KEY Insert_Infinite_Line (double xa, double ya, double za, double xb, double yb, double zb)
void DInsert_Infinite_Line (double xa, double ya, double za, double xb, double yb, double zb)
void Edit_Infinite_Line (HC_KEY key, double xa, double ya, double za, double xb, double yb, double zb)

Function Documentation

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

Adds an infinitely long line to the currently open 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.

DETAILS

Allows the user to insert an infinitely long line segment into the graphics database. At draw time, HOOPS will clip this line to ensure that it is drawn with minimal cost, and that it spans completely across the window into which it is drawn.

NOTES

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

If there is an error the Insert routine returns a -1.

Infinite lines are considered as unbounded geometry and therefore will be ignored for bounding calculations.

RESTRICTIONS

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

void DInsert_Infinite_Line ( double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to Insert_Infinite_Line() but accepts and/or returns double-precision values. This command can only be used when the application links the HOOPS double-precison module.

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.

DETAILS

No additional details. See Insert_Infinite_Line().

void Edit_Infinite_Line ( HC_KEY  key,
double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Modifies an existing infinite line.

Parameters:
key - Key to the infinite line that is to be modified.
xa - new x-coordinate for one end of the line segment.
ya - new y-coordinate for one end of the line segment.
za - new z-coordinate for one end of the line segment.
xb - new x-coordinate for other end of the line segment.
yb - new y-coordinate for other end of the line segment.
zb - new z-coordinate for other end of the line segment.

DETAILS

No additional details. See Insert_Infinite_Line().

NOTES

RESTRICTIONS

See also:
Insert_Infinite_Line, Show_Infinite_Line.

Brief Index      Full Index      Events Index      I.M. Reference