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