Brief Index      Full Index      I.M. Reference

Insert_Infinite_Ray


Functions

void Insert_Infinite_Ray (double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY KInsert_Infinite_Ray (double xa, double ya, double za, double xb, double yb, double zb)
void QInsert_Infinite_Ray (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY QKInsert_Infinite_Ray (const char *segment, 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)
HC_KEY DKInsert_Infinite_Ray (double xa, double ya, double za, double xb, double yb, double zb)
void DQInsert_Infinite_Ray (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY DQKInsert_Infinite_Ray (const char *segment, 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

void 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.

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 KInsert 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.

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

Similar to Insert_Infinite_Ray(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Infinite_Ray()

void QInsert_Infinite_Ray ( const char *  segment,
double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to Insert_Infinite_Ray(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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()

HC_KEY QKInsert_Infinite_Ray ( const char *  segment,
double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to Insert_Infinite_Ray(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

DETAILS

No additional details. See Insert_Infinite_Ray()

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().

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

Similar to DInsert_Infinite_Ray(), but returns an HC_KEY to the object.

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:
key

DETAILS

No additional details. See Insert_Infinite_Ray()

void DQInsert_Infinite_Ray ( const char *  segment,
double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to DInsert_Infinite_Ray(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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()

HC_KEY DQKInsert_Infinite_Ray ( const char *  segment,
double  xa,
double  ya,
double  za,
double  xb,
double  yb,
double  zb 
)

Similar to DInsert_Infinite_Ray(), but operates on a given segment and returns an HC_KEY to the object.

Parameters:
segment - Segment(s) to be inserted into, if other than the currently- open segment.
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:
key

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 
)

Main Index
Brief Index      Full Index      I.M. Functions