Brief Index      Full Index      I.M. Reference

Insert_Infinite_Line


Functions

void Insert_Infinite_Line (double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY KInsert_Infinite_Line (double xa, double ya, double za, double xb, double yb, double zb)
void QInsert_Infinite_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY QKInsert_Infinite_Line (const char *segment, 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)
HC_KEY DKInsert_Infinite_Line (double xa, double ya, double za, double xb, double yb, double zb)
void DQInsert_Infinite_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY DQKInsert_Infinite_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)

Function Documentation

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

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

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

Similar to Insert_Infinite_Line(), 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_Line()

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

Similar to Insert_Infinite_Line(), 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_Line()

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

Similar to Insert_Infinite_Line(), 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_Line()

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

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

Similar to DInsert_Infinite_Line(), 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_Line()

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

Similar to DInsert_Infinite_Line(), 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_Line()

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

Similar to DInsert_Infinite_Line(), 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_Line()

Main Index
Brief Index      Full Index      I.M. Functions