DrawDibDraw function draws a DIB to the screen.
The DrawDibDraw function draws a DIB to the screen.
BOOL DrawDibDraw( HDRAWDIBhdd, HDChdc, intxDst, intyDst, intdxDst, intdyDst, LPBITMAPINFOHEADERlpbi, LPVOIDlpBits, intxSrc, intySrc, intdxSrc, intdySrc, UINTwFlags );Parameters
hdd
Handle to a DrawDib DC.
hdc
Handle to the DC.
xDst
The x-coordinate, in MM_TEXT client coordinates, of the upper left corner of the destination rectangle.
yDst
The y-coordinate, in MM_TEXT client coordinates, of the upper left corner of the destination rectangle.
dxDst
Width, in MM_TEXT client coordinates, of the destination rectangle. If dxDst is - 1, the width of the bitmap is used.
dyDst
Height, in MM_TEXT client coordinates, of the destination rectangle. If dyDst is - 1, the height of the bitmap is used.
lpbi
Pointer to the BITMAPINFOHEADER structure containing the image format. The color table for the DIB within BITMAPINFOHEADER follows the format and the biHeight member must be a positive value; DrawDibDraw will not draw inverted DIBs.
lpBits
Pointer to the buffer that contains the bitmap bits.
xSrc
The x-coordinate, in pixels, of the upper left corner of the source rectangle. The coordinates (0,0) represent the upper left corner of the bitmap.
ySrc
The y-coordinate, in pixels, of the upper left corner of the source rectangle. The coordinates (0,0) represent the upper left corner of the bitmap.
dxSrc
Width, in pixels, of the source rectangle.
dySrc
Height, in pixels, of the source rectangle.
wFlags
Applicable flags for drawing. The following values are defined.
Value | |
DDF_BACKGROUNDPAL | |
DDF_DONTDRAW | |
DDF_FULLSCREEN | |
DDF_HALFTONE | |
DDF_HURRYUP | |
DDF_NOTKEYFRAME | |
DDF_SAME_HDC | |
DDF_SAME_DRAW | |
DDF_UPDATE |
Return Values
Returns TRUE if successful or FALSE otherwise.
Remarks
DDF_DONTDRAW causes DrawDibDraw to decompress but not display an image. A subsequent call to DrawDibDraw specifying DDF_UPDATE displays the image.
If the DrawDib DC does not have an off-screen buffer specified, specifying DDF_DONTDRAW causes the frame to be drawn to the screen immediately. Subsequent calls to DrawDibDraw specifying DDF_UPDATE fail.
Although they are set at different times, DDF_UPDATE and DDF_DONTDRAW can be used together to create composite images off-screen. When the off-screen image is complete, you can display the image by calling DrawDibDraw.
Requirements
Windows NT/2000/XP: Included in Windows NT 3.1 and later.
Windows 95/98/Me: Included in Windows 95 and later.
Header: Declared in Vfw.h.
Library: Use Vfw32.lib.
Used: xiazeju
