DIB_StretchBlt

BOOL DIB_StretchBlt(LPPDEVICE lpDestDev, WORD wDestX, WORD wDestY,
    WORD wDestWidth, WORD wDestHeight, LPPDEVICE lpSrcDev, 
    WORD wSrcX, WORD wSrcY, WORD wSrcWidth,  WORD wtSrcHeight, 
    DWORD dwRop3, LPBRUSH lpPBrush, LPDRAWMODE lpDrawMode, 
    LPRECT lpClipRect)

Transfers bits from a rectangle on a source device to a rectangle on a destination device, stretching or compressing the bitmap to fit the dimensions of the destination rectangle. The transfer is controlled by a ternary raster operation value that specifies how corresponding bits from the source, destination, and pattern in a brush are combined to form the final bits in the destination.

• Returns TRUE if successful, or FALSE otherwise.

lpDestDev

Address of PDEVICE or PBITMAP structure specifying the destination device or bitmap.

wDestX and wDestY

The x- and y-coordinates (in device units) of the upper left corner of the rectangle on the destination device to receive the transferred bits.

wDestWidth and wDestHeight

The width and height of the destination rectangle.

lpSrcDev

Address of PDEVICE or PBITMAP structure specifying the source device or bitmap.

wSrcX and wSrcY

The x- and y-coordinates (in device units) of the upper left corner of the rectangle on the source device containing the bits to transfer.

wSrcWidth and wSrcHeight

The width and height (in device units) of the rectangles on the source device.

dwRop3

Specifies a ternary raster-operation value. This value determines how StretchBlt combines corresponding pixels from the source, destination, and brush to produce the final pixels in the destination rectangle. The Rop3 parameter can be any one of 256 ternary raster-operation values. See DIB_BitBlt for a table listing the most common values.

lpPBrush

Address of a PBRUSH structure specifying a physical brush. StretchBlt uses this brush only if the Rop3 parameter specifies a ternary raster operation that requires the brush to be combined with the source, destination, or both.

lpDrawMode

Address of a DRAWMODE structure specifying the color information StretchBlt needs to determine patterned brush colors and to carry color conversions and transparent copy operations.

lpClipRect

Address of a RECT structure specifying the dimensions of a rectangle in device units that is used for clipping.

The export ordinal for this function is 27.