SECImage::StretchDIBits

int SECImage::StretchDIBits(CDC * pDC, int XDest, int YDest, int cxDest, int cyDest, int XSrc, int YSrc, int cxSrc, int cySrc, const void FAR* lpvBits, LPBITMAPINFO lpbmi, UINT fuColorUse, DWORD fdwRop)

Encapsulates the ::StretchDIBits() call.

Defined in: SECIMAGE.cpp

Return Value

If successful, returns the number of scan lines copied.

Parameters

pDC

Pointer to device context.

XDest

Specifies the x-coordinate, in logical units, of the upper-left corner of the destination rectangle.

YDest

Specifies the y-coordinate, in logical units, of the upper-left corner of the destination rectangle.

cxDest

Specifies the width, in logical units, of the destination rectangle

cyDest

Specifies the height, in logical units, of the destination rectangle.

XSrc

Specifies the x-coordinate, in pixels, of the source rectangle in the DIB

YSrc

Specifies the y-coordinate, in pixels, of the source rectangle in the DIB.

cxSrc

Specifies the width, in pixels, of the source rectangle in the DIB.

cySrc

Specifies the height, in pixels, of the source rectangle in the DIB.

lpvBits

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

lpbmi

Pointer to a BITMAPINFO structure that contains information about the DIB.

fuColorUse

Specifies whether the bmiColors member of the BITMAPINFO structure was provided and, if so, whether bmiColors contains explicit red, green, blue (RGB) values or indexes.

fdwRop

Specifies how the source pixels, the destination device context's current brush, and the destination pixels are to be combined to form the new image.

Comments

If m_bUseHalftone is specified, the function auto-detects whether a display has less color resolution than the current bitmap, and if so, uses a halftone paint.

See Also

SECImage