writeRGB(3G)

NAME
     writeRGB - paints a row of pixels on the screen

C SPECIFICATION
     void writeRGB(n, red, green, blue)
     short n;
     RGBvalue 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
     writeRGB 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.  writeRGB does not automatically wrap from one line
     to the next.  The current character position becomes undefined if the new
     position is outside the viewport.

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

SEE ALSO
     lrectwrite

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

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