Function Entry: GRVECS

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: GRVECS

Name

grvecs

Class

Function

Syntax

(grvecs vlist [trans])

Arguments and Values

  • vlist: a vector list of optional color integers paired with two point lists, in the form ([color1] from1 to1 [color2] from2 to2 …). Color values 0–255 are AutoCAD colors; values above 255 select XOR ink; negative values select the device's highlight style.
  • trans (optional): a 44 transformation matrix (a list of four 4-real lists) that repositions or scales every vector in vlist.

Description

Draws multiple transient vectors in the drawing area. A specified color persists for all subsequent vectors until another color value is given.

Return Values

Always returns nil.

Side Effects

Draws transient graphics; nothing is committed to the drawing database.

Examples

  • Five vertical lines with five different colors: 

    (grvecs '(1 (1 2)(1 5)
          2 (2 2)(2 5)
          3 (3 2)(3 5)
          4 (4 2)(4 5)
          5 (5 2)(5 5)))

  • Identity transformation with translation (5,5,0): 

    '((1.0 0.0 0.0 5.0)
  (0.0 1.0 0.0 5.0)
  (0.0 0.0 1.0 0.0)
  (0.0 0.0 0.0 1.0))

Availability

  • AutoCAD 2026: documented.
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.