v(3G)

NAME
     v2d, v2f, v2i, v2s, v3d, v3f, v3i, v3s, v4d, v4f, v4i, v4s - transfers a
     2-D, 3-D, or 4-D  vertex to the graphics pipe

FORTRAN 77 SPECIFICATION
     subroutine v2s(vector)              subroutine v2f(vector)
     integer*2 vector(2)                 real vector(2)

     subroutine v2i(vector)              subroutine v2d(vector)
     integer*4 vector(2)                 double precision vector(2)

     subroutine v3s(vector)              subroutine v3f(vector)
     integer*2 vector(3)                 real vector(3)

     subroutine v3i(vector)              subroutine v3d(vector)
     integer*4 vector(3)                 double precision vector(3)

     subroutine v4s(vector)              subroutine v4f(vector)
     integer*2 vector(4)                 real vector(4)

     subroutine v4i(vector)              subroutine v4d(vector)
     integer*4 vector(4)                 double precision vector(4)

PARAMETERS
     vector   expects a 2, 3, or 4 element array, depending on whether you
              call the v2, v3, or v4 version of the routine.  The elements of
              the array are the coordinates of the vertex (point) that you
              want to transfer to the graphics pipe. Put the x coordinate in
              element 1, the y coordinate in element 2, the z coordinate in
              element 3 (for v3 and v4), and the w coordinate in element 4
              (for v4).

DESCRIPTION
     v transfers a single 2-D (v2), 3-D (v3), or 4-D (v4) vertex to the
     graphics pipe.  The coordinates are passed to v as an array. Separate
     subroutines are provided for 16-bit integers (s), 32-bit integers limited
     to a signed 24-bit range (i), 32-bit IEEE single precision floats (f),
     and 64-bit IEEE double precision floats (d).  The z coordinate defaults
     to 0.0 if not specified.  w defaults to 1.0.

     The Graphics Library subroutines bgnpoi, endpoi, bgnlin, endlin, bgnclo,
     endclo, bgnpol, endpol, bgntme, endtme, bgnqst, and endqst determine how
     the vertex is interpreted.  For example, vertices specified between
     bgnpoi and endpoi draw single pixels (points) on the screen.  Likewise,
     those specified between bgnlin and endlin draw a sequence of lines (with
     the line stipple continued through internal vertices).  Closed lines
     return to the first vertex specified, producing the equivalent of an
     outlined polygon.

     Vertices specified when none of bgnpoi, bgnlin, bgnclo, bgnpol, bgntme,
     and bgnqst are active simply set the current graphics position.  They do
     not have any effect on the frame buffer contents.  (Refer to the pages
     for bgnpoi, bgnlin, bgnclo, bgnpol, bgntme, and bgnqst for their effect
     on the current graphics position.)

SEE ALSO
     bgnclo, bgnlin, bgnpoi, bgnpol, bgntme, bgnqst

BUGS
     On the IRIS-4D/120GTX and IRIS-4D/140GTX, there is problem with the
     graphics DMA hardware that can cause data to be sent to the hardware
     after the subroutine call has returned.  If the data is modified immedi-
     ately after the subroutine call, the modified data may get sent down.  To
     avoid this, don't modify the data until after another n, v, or c call has
     been made.

     This is an example of the bug: