DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CopyRect(D3nfb)


CopyRect -- NFB primitive to copy one rectangle

Synopsis

#include "nfbWinStr.h"

void xxxCopyRecti ( BoxPtr pdstBox, DDXPointPtr psrc, unsigned char alu, unsigned long planemask, DrawablePtr pDrawable);

xxx is the routine's prefix. Valid values are gen to use the default routine or your driver's prefix if you are rewriting this routine to use the specific capabilities of your hardware.

Description

CopyRect performs a screen-to-screen copy of one rectangle, while applying alu and planemask to all writes. This routine must be able to handle all cases of overlapping copies. The destination rectangle is described by pdstBox and the source pointer is psrc.

Arguments

The arguments are:

pdstBox *
pointer to a BoxRec(D4nfb). structure that describes the rectangle in which the line of glyphs is to be drawn. pbox->x1, pbox->y1 points to the first pixel at which the upper-left corner of the first glyph should appear.

psrc *
pointer to the source point of the upper left corner of the rectangle to be ``blitted''. See DDXPointRec(D4nfb) or ``Blit'' in Developing NFB graphics adapter drivers for more information.

alu
alu to be applied. See ``alu'' in Developing NFB graphics adapter drivers for more information.

planemask
the window planes to be affected.

pDrawable
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

The source and destination may overlap. Some graphics engines require the programmer to set a direction flag to avoid the source being incorrectly clobbered, while other graphics engines are smart enough to correctly deal with overlapping ``blits'' internally.

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/gen/genRectOps.c

Driver source file
xxxBlit.c

Defined in
nfbWinOps(D4nfb) structure in xxxData.c

Prototyped in
xxxProcs.h

References

DDXPointRec(D4nfb), nfbWinOps(D4nfb)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005