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)