writepixels(3G)						       writepixels(3G)

NAME    [Toc]    [Back]

     writepixels - paints a row	of pixels on the screen

C SPECIFICATION    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

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

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

     lrectwrite

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111