Brief Index      Full Index      Events Index      I.M. Reference

Insert_Infinite_Ray

Functions

HC_KEY Insert_Infinite_Ray (double xa, double ya, double za, double xb, double yb, double zb)
void DInsert_Infinite_Ray (double xa, double ya, double za, double xb, double yb, double zb)
void Edit_Infinite_Ray (HC_KEY key, double xa, double ya, double za, double xb, double yb, double zb)

Function Documentation

HC_KEY Insert_Infinite_Ray ( 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 a line that is infinitely long in one directiona The line starts at (xa, ya, za) and passes through (xb, yb, yz) to infinity. 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 rays, like infinite lines, are considered as unbounded geometry and therefore will be ignored for bounding calculations.

RESTRICTIONS

See also:
Insert_Infinite_Line, Insert_Ink, Insert_Polyline, Set_Line_Pattern, Set_Line_Weight, Set_Color, Set_Visibility, Show_Infinite_Ray, Show_Infinite_Line, Renumber_Key.
void DInsert_Infinite_Ray ( double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to Insert_Infinite_Ray() 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_Ray().

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

Modifies an existing infinite ray.

Parameters:
key- Key to the infinite ray 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_Ray().

NOTES

RESTRICTIONS

See also:
Insert_Infinite_Ray, Insert_Infinite_Line, Insert_Ink, Insert_Polyline, Set_Line_Pattern, Set_Line_Weight, Set_Color, Set_Visibility, Show_Infinite_Ray, Show_Infinite_Line, Renumber_Key.

Brief Index      Full Index      Events Index      I.M. Reference