writep(3G)

NAME
     writep - paints a row of pixels on the screen

FORTRAN 77 SPECIFICATION
     subroutine writep(n, colors)
     integer*4 n
     integer*2 colors(n)

PARAMETERS
     n        expects the number of pixels you want to paint.

     colors   expects an array of color indices.  The system reads n elements
              from this array and writes a pixel of the appropriate color for
              each.

DESCRIPTION
     writep paints a row of pixels on the screen in color map mode.  The
     starting location is the current character position.  The system updates
     the current character position to one pixel to the right of the last
     painted pixel.  The system paints pixels from left to right, and clips to
     the current screenmask.

     writep does not automatically wrap from one line to the next.  The
     current character position becomes undefined if the new position is
     outside the viewport.

     The system must be in color map mode for writep to function correctly.

SEE ALSO
     lrectw

NOTES
     writep should not be used in new development.  Rather, pixels should be
     written using the high-performance lrectw command.

     This routine is available only in immediate mode.