Brief Index      Full Index      I.M. Reference

Insert_Line


Functions

void Insert_Line (double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY KInsert_Line (double xa, double ya, double za, double xb, double yb, double zb)
void QInsert_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY QKInsert_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
void DInsert_Line (double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY DKInsert_Line (double xa, double ya, double za, double xb, double yb, double zb)
void DQInsert_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)
HC_KEY DQKInsert_Line (const char *segment, double xa, double ya, double za, double xb, double yb, double zb)

Function Documentation

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

Adds a simple line segment to the current graphics 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

This is a primitive way to insert lines into your scene. More flexible routines include Insert_Polyline() , which requires passing all the x-y-z values at once, and Insert_Ink() , which requires multiple calls to draw a line.

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.

RESTRICTIONS

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

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

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

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

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

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

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

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

Similar to Insert_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_Line().

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

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

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

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

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

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

Main Index
Brief Index      Full Index      I.M. Functions