BitBlockTransfer


static void BitBlockTransfer(Handle Device,
                             int X,
                             int Y,
                             int Width,
                             int Height,
                             Handle Source,
                             int Left,
                             int Top,
                             unsigned Raster)

This function transfers a rectangle of pixels between device contexts.

Parameters

Handle Device

The handle of the device context.

int X

The x-coordinate of the upper-left corner of the destination rectangle.

int Y

The y-coordinate of the upper-left corner of the destination rectangle.

int Width

The width of the destination rectangle.

int Height

The height of the destination rectangle.

Handle Source

The handle of the device context from which bits are copied.

int Left

The x-coordinate of the upper-left corner of the source rectangle.

int Top

The y-coordinate of the upper-left corner of the source rectangle.

unsigned Raster

The raster operations used to combine the destination brush with the source and destination pixels.

Notes

An error is flagged if the source device context has a rotation or shearing transformation in effect.

If a non-shearing, non-rotating transformation is in effect in the source device context and a matching transformation is not in effect in the destination device context, the destination rectangle is transformed to accommodate the bit transfer.

A color conversion is performed when the source and destination device contexts have different color formats.

The source and destination device contexts must represent the same device.

Not all devices support bit block transfers. The function GetDeviceCapabilities (capability index Capability::Raster, value CapabilityRaster::BitBlock) may be used to ascertain the support for bit block transfers.

Details

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