NAME

writeRGB − paints a row of pixels on the screen

SPECIFICATION

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

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

Pascal
procedure writeRGB(n: Short; var red, green,
blue: RGBvalue);

DESCRIPTION

writeRGB paints a row of pixels on the screen in RGB mode.  n specifies the number of pixels to paint; red, green, blue specify arrays of colors for each pixel.  The starting location is the current character postition.  The system updates the current character position to the pixel that follows the last painted pixel.  The current character position becomes undefined if the updated pixel position is greater than XMAXSCREEN. 

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.  It supplies a 24-bit RGB value (8 bits for each color) for each pixel.  This value is written directly into the bitplanes. 
 

SEE ALSO

readRGB, RGBcolor, RGBwritemask, scrmask, writepixels Programming Guide, Section 3.9, Writing and Reading Pixels

NOTE

This routine is available only in immediate mode and RGB mode. 

Version 3.6  —  December 20, 1987