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