CombineDIB Method

Description         This method will combine two device independent bitmap (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. If the bitmap has deferent 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 saource and the mask DIB must be equal.

Other rules:

- If the destination DIB is NULL then create a destination DIB based on the source.

- If the mask DIB is NULL combine source with destination.

- If the mask DIB and destination DIB is NULL then just return the source.

Syntax                 hRet = [BiDib.]CombineDIB X Y Dest Src Mask Mode

Remarks             hRet                        LONGLONG The destination DIB on success, 0 if failed.

                            X                             Short               The destination X coordinate of the source bitmap on the destination bitmap.

                            Y                             Short               The destination Y coordinate of the source bitmap on the destination bitmap.

                            Dest                        LONGLONG The destination DIB. If Dest = 0 then method creates an empty DIB and use it as the destination.

                            Src                          LONGLONG The source DIB.

                            Mask                      LONGLONG The mask DIB.

                            Mode                      Short               The masking mode Opaque or Transparent. combopaque or combTransparent.

See Also