DIB_StretchDIBits

BOOL DIB_StretchDIBits(LPPDEVICE lpDestDev, WORD fGet, 
    WORD wDestX, WORD wDestY, WORD wDestWidth, WORD wDestHeight,
    WORD wSrcX, WORD wSrcY, WORD wSrcWidth, WORD wSrcHeight, 
    VOID *lpBits, LPBITMAPINFO lpInfo, LPINT lpTranslate, 
    DWORD dwRop3, LPBRUSH lpPBrush, LPDRAWMODE lpDrawMode, 
    LPRECT lpClipRect)

Moves a source bitmap into a destination bitmap, stretching or compressing the source bitmap as necessary to fit the dimensions of the destination bitmap. The function either converts and copies a device-independent bitmap (DIB) to a given device or converts and copies a device-dependent bitmap (DDB) to a DIB. The fGet parameter specifies whether the source bitmap is a DIB or a DDB.

• Returns TRUE if successful, or FALSE otherwise.

lpDestDev

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

fGet

Flag specifying whether to set or retrieve bitmap bits. If this parameter is zero, the function stretches or compresses the bitmap bits in the buffer pointed to by the lpBits parameter and copies them to the given device or bitmap. If this parameter is 1, the function retrieves bits from the device or bitmap.

wDestX

The x-coordinate, in device units, of the upper left corner of the destination rectangle.

wDestY

The y-coordinate, in device units, of the upper left corner of the destination rectangle.

wDestWidth

The width, in device units, of the destination rectangle.

wDestHeight

The height, in device units, of the destination rectangle.

wSrcX

The x-coordinate, in device units, of the source rectangle in the DIB.

wSrcY

The y-coordinate, in device units, of the source rectangle in the DIB.

wSrcWidth

The width, in device units, of the source rectangle in the DIB.

wSrcHeight

The height, in device units, of the source rectangle in the DIB.

lpBits

Address of the DIB bits, which are stored as an array of bytes.

lpInfo

Address of a BITMAPINFO structure that contains information about the DIB.

lpTranslate

Address of an array of color translation values for converting palette colors to actual device colors. This parameter is ignored by devices that do not use color palettes.

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 dwRop3 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 28