| Home
| Previous
| Next
| Up

MGL_bitBltPattCoord

Blts a block of image data from one device context into another while applying a mono or color pattern.

Declaration

void MGLAPI MGL_bitBltPattCoord(
MGLDC *dst,
MGLDC *src,
int left,
int top,
int right,
int bottom,
int dstLeft,
int dstTop,
int usePixMap,
int rop3)

Prototype In

mgraph.h

Parameters

dst | Destination device context
src | Source device context
left | Left coordinate of image to Blt from
top | Top coordinate of image to Blt from
right | Right coordinate of image to Blt from
bottom | Bottom coordinate of image to Blt from
dstLeft | Left coordinate to Blt to
dstTop | Right coordinate to Blt to
usePixMap | True to use color pixmap pattern, false for mono bitmap pattern
rop3 | ROP3 raster operation code to use during Blt (MGL_rop3CodesType)

Description

Copies a block of bitmap data from one device context to another, while applying either a mono bitmap pattern or a color pixmap pattern to the data with a ternary raster operation code (ROP3). If the usePixMap parameter is set to true, the current pixmap pattern set by MGL_setPenPixmapPattern will be applied as pattern data, otherwise the current monochrome bitmap pattern set by MGL_setPenBitmapPattern will be applied.

The source and destination rectangles may overlap even if the source and destination device contexts are the same, and MGL will correctly handle the overlapping regions.

This function will only work with Blt's between device contexts that have identical pixel formats. If the color depth or pixel formats are different, this function will produce undefined results.

The ROP3 code specifies how the source, pattern and destination image data should be combined to produce the final result. SciTech MGL supports all 256 ROP3 codes, and they are enumerated in MGL_rop3CodesType.

The source and destination rectangles are clipped according to the current clipping rectangles for the source and destination device contexts respectively.

Note: This function is not designed to support overlapping source and destination rectangles on the same device context so if the source and destination rectangles overlap on the same device context, the results are undefined.

See Also

MGL_bitBlt, MGL_bitBltCoord, MGL_srcTransBlt, MGL_srcTransBltCoord, MGL_dstTransBlt, MGL_dstTransBltCoord, MGL_bitBltPatt, MGL_bitBltPattCoord, MGL_bitBltFx, MGL_bitBltFxCoord, MGL_stretchBlt, MGL_stretchBltCoord, MGL_stretchBltFx, MGL_stretchBltFxCoord, MGL_copyPage, MGL_copyPageCoord

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com