writeRGB(3G)							  writeRGB(3G)

NAME    [Toc]    [Back]

     writeRGB -	paints a row of	pixels on the screen

C SPECIFICATION    [Toc]    [Back]

     void writeRGB(n, red, green, blue)
     short n;
     RGBvalue red[], green[], blue[];

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     lrectwrite

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111