acedGrVecs

C++

int acedGrVecs(
    const struct resbuf * vlist, 
    ads_matrix mat
);

File

acedads.h

Description

Draws multiple vectors on the graphics screen.

Result-buffer elements in the vlist can be as follows:

• A pair of points (RTPOINT or RT3DPOINT) that specify the endpoints of the vector, expressed in the current UCS; these can be three-dimensional points.

Note You must pass these points as pairs--that is, in two successive result buffers--or the acedGrVecs() call will fail.

• A color value that applies to all succeeding vectors until vlist specifies another color. The color is specified as a short integer (RTSHORT). AutoCAD colors are in the range 0-255. If the color value is greater than 255, succeeding vectors are drawn in XOR ink, which complements anything it draws over and erases itself when overdrawn. If the color value is less than 0, the vector is highlighted.

AutoCAD clips the vectors as required to fit the screen.

The mat argument is useful in conjunction with acedDragGen() when you want to display vectors that are transformed with the selection set.

If it succeeds, acedGrVecs() returns RTNORM; it returns RTERROR if it encounters a result buffer of the wrong type or if the points in vlist are not paired correctly.

Parameters