draw(3G)

NAME
     draw, drawi, draws, draw2, draw2i, draw2s - draws a line

C SPECIFICATION
     void draw(Coord x, Coord y, Coord z)

     void drawi(Icoord x, Icoord y, Icoord z)

     void draws(Scoord x, Scoord y, Scoord z)

     void draw2(Coord x, Coord y)

     void draw2i(Icoord x, Icoord y)

     void draw2s(Scoord x, Scoord y)

     All of the above functions are functionally the same except for the type
     declarations of the parameters.  In addition the draw2* routines assume a
     2-D point instead of a 3-D point.

PARAMETERS
     x   expects the x coordinate of the point to which you want to draw a
         line segment.

     y   expects the y coordinate of the point to which you want to draw a
         line segment.

     z   expects the z coordinate of the point to which you want to draw a
         line segment.  (Not used by 2-D subroutines.)

DESCRIPTION
     draw connects the point x, y, z and the current graphics position with a
     line segment.  It uses the current linestyle, linewidth, color (if in
     depth-cue mode, the depth-cued color is used), and writemask.

     draw updates the current graphics position to the specified point.  Do
     not place routines that invalidate the current graphics position within
     sequences of moves and draws.

SEE ALSO
     bgnline, endline, move, v, getgpos

NOTE
     draw should not be used in new development.  Rather, lines should be
     drawn using the high-performance v commands, surrounded by calls to
     bgnline and endline.