DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005