writepixels(3G)

NAME
     writepixels - paints a row of pixels on the screen

C SPECIFICATION
     void writepixels(n, colors)
     short n;
     Colorindex colors[];

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
     writepixels 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.

     writepixels 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 writepixels to function
     correctly.

SEE ALSO
     lrectwrite

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

     This routine is available only in immediate mode.