writeR(3G)

NAME
     writeR - paints a row of pixels on the screen

FORTRAN 77 SPECIFICATION
     subroutine writeR(n, red, green, blue)
     integer*4 n
     character*(*) red, green, blue

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

     red     expects an array containing red values for the pixels you paint.
             You need a red value for each pixel you paint.

     green   expects an array containing green values for the pixels you
             paint.  You need a green value for each pixel you paint.

     blue    expects an array containing blue values for the pixels you paint.
             You need a blue value for each pixel you paint.

DESCRIPTION
     writeR paints a row of pixels on the screen in RGB 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.  Pixels are painted from left to right, and are clipped to the
     current screenmask.  writeR does not automatically wrap from one line to
     the next.  The current character position becomes undefined if the new
     position is outside the viewport.

     writeR supplies a 24-bit RGB value (8 bits for each color) for each
     pixel.  This value is written directly into the bitplanes.

SEE ALSO
     lrectw

NOTES
     writeR 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.

     When there are only 12 color bitplanes available, the lower 4 bits of
     each color are ignored.