#include "BIDIB.H"
UINT CALLBACK CombineDIB( int X,
int Y,
HANDLE* hDestination,
HANDLE hSource,
HANDLE hMask
DWORD dwMode)
Description
This function will combine two device independent bitmaps (DIB) with a mask. The mask is also a device independent bitmap. The mask should be used to combine the source bitmap with the destination bitmap.
Parameters
|
int |
X |
The destination X coordinate of the source bitmap on the destination bitmap. |
|
int |
Y |
The destination Y coordinate of the source bitmap on the destination bitmap. |
|
HANDLE |
*hDestination |
The destination DIB, if Null handle then create an empty DIB and use it as the destination. |
|
HANDLE |
hSource |
The source DIB. |
|
HANDLE |
hMask |
The mask DIB. |
|
DWORD |
dwMode |
The masking mode Opaque or Transparent. COMB_OPAQU and COMB_TRANSPARENT. |
Return values
TRUE on success, FALSE if failed.
Requirements
Header : Declared in BiDIB.h; include BiDIB.h.
Library : Use BiDIB.lib.
DLLs : BiDIB.dll.
Programming notes
If the bitmap has different planes follow the following rules:
If the source DIB and mask DIB have different bit per planes than the destination:
first convert the source DIB and the mask DIB to the same bit per planes as the destination DIB. The result will be combined.
The size of the source and the mask DIB must be equal.
Other rules:
a. If the destination DIB is NULL then create a destination DIB based on the source.
b. If the mask DIB is NULL combine the source with destination.
c. If the mask DIB and destination DIB are NULL then just return the source.