nfbReplicateArea(D3nfb)

nfbReplicateArea -- NFB routine to replicate part of a pixmap

Synopsis

#include "nfbProcs.h"

void nfbReplicateArea (
	BoxPtr pbox,
	unsigned int tilew,
	unsigned int tileh,
	unsigned long planemask,
	DrawablePtr pDraw);

Description

nfbReplicateArea( ) replicates a portion of the pixmap pointed to by pDraw throughout the screen area pointed to by pbox, applying planemask.

Arguments

The arguments are:

pbox: points to a BoxRec(D4nfb) that describes the final size of the pattern-filled rectangle.
tilew and tileh: specifies the width and height of the portion of the tile that must exist when nfbReplicateArea( ) is called. The complete coordinates of that initial pattern are therefore (pbox->x1, pbox->y1) and (pbox->x1 + tilew, pbox->y1 + tileh).
planemask: can be applied with this operation (planemask refers to the window planes to be affected).
pDraw: pointer to an X structure called DrawableRec. This pointer is only used to access your screen private data. The ScreenRec structure is pointed to by pDrawable->pScreen. Your screen private is connected to the bottom of ScreenRec.

Exit codes

None

Usage

nfbReplicateArea is very useful for drawing both tiles and opaque stipples. It can only be used in situations where the alu needed for the drawing operation does not require mixing the source pixel with the destination pixel, such as when the alu is GXxor. In such cases, the source pixel will clobber the destination pixel.

Version applicability

This function is supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.

Source files

Routine source: ./hw/sco/ports/nfb/nfbRep.c
Driver source file: xxxStip.c
xxxTile.c

References

BoxRec(D4nfb), FillRects(D3nfb)