TransparentBitBlockTransfer


static void TransparentBitBlockTransfer(Handle Destination,
                                        int DestinationX,
                                        int DestinationY,
                                        int DestinationWidth,
                                        int DestinationHeight,
                                        Handle Source,
                                        int SourceX,
                                        int SourceY,
                                        int SourceWidth,
                                        int SourceHeight,
                                        unsigned TransparentRedGreenBlue)

This function performs a bit block transfer of the color data of a rectangle of pixels from a source device context into a destination device context.

Parameters

Handle Destination

The handle of the destination device context.

int DestinationX

The x-coordinate (in logical units) of the upper-left corner of the destination rectangle.

int DestinationY

The y-coordinate (in logical units) of the upper-left corner of the destination rectangle.

int DestinationWidth

The width (in logical units) of the destination rectangle.

int DestinationHeight

The height (in logical units) of the destination rectangle.

Handle Source

The handle of the source device context.

int SourceX

The x-coordinate (in logical units) of the source rectangle.

int SourceY

The y-coordinate (in logical units) of the source rectangle.

int SourceWidth

The width (in logical units) of the source rectangle.

int SourceHeight

The height (in logical units) of the source rectangle.

unsigned TransparentRedGreenBlue

The red, green, blue color in the source bitmap to be treated as transparent.

Notes

This function is supported for source bitmaps with 4 bits per pixel and 8 bits per pixel. The function AlphaBlend may be used to specify 32-bit per pixel bitmaps with transparency.

If the source and destination rectangles are not the same size, the source bitmap is scaled to match the destination rectangle. When the function SetStretchBitBlockMode is used, the modes StretchBlockMode::And and StretchBlockMode::Or are converted to StretchBlockMode::Drop for this function.

This function does not mirror a bitmap if either the width or height, of either the source or destination, is negative.

Details

Name Space IPlusPlus::Graphics
Class Gdi
Assembly IPlusPlus.WinPlus.dll