sds_grvecs

int sds_grvecs (const struct sds_resbuf *vlist, sds_matrix mat);


Draw vectors on the screen.


This function draws one or more vectors on the screen, unlike the sds_grdraw, which draws a single vector. Vectors can be displayed in any of the standard colors and can be highlighted or displayed normally.

The argument vlist represents a list of result buffers that specify the vectors. The vectors are clipped as required. The vlist consists of point pairs and a color. RTPOINT specifies a pair of 2D x,y-coordinates; or RT3DPOINT specifies a pair of 3D x,y,z-coordinates.

RTSHORT specifies the color of the vector:

Color Meaning
-1 Vector is highlighted.
0 -255 Standard colors.
256 Vector is drawn in XOR ink.

NOTE When vectors are drawn in XOR ink and one XOR-colored vector overdraws another vector, it is drawn in a complimentary color. When an XOR-color vector overdraws itself, it becomes invisible.

The argument mat is a 4 x 4 matrix that transforms the vectors before they are displayed.

This function returns RTERROR or RTNONE.

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)

sds_grdraw