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)
 

Detailed Description

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