DrawDibBegin-Funktion (vfw.h)
Die DrawDib-Funktion ändert die Parameter eines DrawDib-DC oder initialisiert einen neuen DrawDib-DC.
Syntax
BOOL VFWAPI DrawDibBegin(
HDRAWDIB hdd,
HDC hdc,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int dxSrc,
int dySrc,
UINT wFlags
);
Parameter
hdd
Handle mit einem DrawDib DC.
hdc
Handle für einen DC zum Zeichnen. Dieser Parameter ist optional.
dxDst
Breite des Zielrechtecks in MM_TEXT Clienteinheiten.
dyDst
Höhe des Zielrechtecks in MM_TEXT Clienteinheiten.
lpbi
Zeiger auf eine BITMAPINFOHEADER-Struktur , die das Bildformat enthält. Die Farbtabelle für den DIB folgt dem Bildformat, und der biHeight-Member muss ein positiver Wert sein.
dxSrc
Breite des Quellrechtecks in Pixel.
dySrc
Höhe des Quellrechtecks in Pixel.
wFlags
Anwendbare Flags für die Funktion. Die folgenden Werte werden definiert.
| Wert | Bedeutung |
|---|---|
| DDF_ANIMATE | Ermöglicht die Palettenanimation. Wenn dieser Wert vorhanden ist, reserviert DrawDib so viele Einträge wie möglich, indem PC_RESERVED in den PalPalEntry-Arrayeinträgen der LOGPALETTE-Struktur festgelegt wird, und die Palette kann mithilfe der DrawDibChangePalette-Funktion animiert werden. Wenn Ihre Anwendung die DrawDibBegin-Funktion mit der DrawDibDraw-Funktion verwendet, legen Sie diesen Wert mit DrawDibBegin anstelle von DrawDibDraw fest. |
| DDF_BACKGROUNDPAL | Realisiert die zum Zeichnen verwendete Palette als Hintergrundaufgabe, sodass die aktuelle Palette, die für die Anzeige verwendet wird, unverändert bleibt. (Dieser Wert schließt sich gegenseitig von DDF_SAME_HDC aus.) |
| DDF_BUFFER | Bewirkt, dass DrawDib versucht, einen Off-Screen-Puffer zu verwenden, damit DDF_UPDATE verwendet werden kann. Dadurch wird die Dekomprimierung und das zeichnen direkt auf dem Bildschirm deaktiviert. Wenn DrawDib keinen Off-Screen-Puffer erstellen kann, dekomprimiert es oder zeichnet direkt auf den Bildschirm. Weitere Informationen finden Sie in den fürDrawDibDraw beschriebenen DDF_UPDATE- und DDF_DONTDRAW-Werten. |
| DDF_DONTDRAW | Das aktuelle Bild wird nicht gezeichnet, sondern dekomprimiert. DDF_UPDATE kann später zum Zeichnen des Bilds verwendet werden. Dieses Flag ersetzt das DDF_PREROLL-Flag . |
| DDF_FULLSCREEN | Wird nicht unterstützt. |
| DDF_HALFTONE | Dithert den DIB immer in eine Standardpalette, unabhängig von der Palette des DIB. Wenn Ihre Anwendung DrawDibBegin mit DrawDibDraw verwendet, legen Sie diesen Wert mit DrawDibBegin anstelle von DrawDibDraw fest. |
| DDF_JUSTDRAWIT | Zeichnet das Bild mithilfe von GDI. Verhindert das Dekomprimieren, Dehnen oder Dithering des Bilds durch DrawDib-Funktionen. Dadurch werden DrawDib-Funktionen entfernt, die sich von der StretchDIBits-Funktion unterscheiden. |
| DDF_SAME_DRAW | Verwenden Sie die aktuellen Zeichnungsparameter für DrawDibDraw. Verwenden Sie diesen Wert nur, wenn sich lpbi, dxDest, dyDest, dxSrc und dySrc seit der Verwendung von DrawDibDraw oder DrawDibBegin nicht geändert haben. Dieses Flag ersetzt die DDF_SAME_DIB- und DDF_SAME_SIZE-Flags. |
| DDF_SAME_HDC | Verwenden Sie den aktuellen DC-Handle und die Palette, die derzeit dem DC zugeordnet ist. |
| DDF_UPDATE | Die letzte gepufferte Bitmap muss neu gezeichnet werden. Wenn das Zeichnen mit diesem Wert fehlschlägt, ist kein gepuffertes Bild verfügbar, und ein neues Bild muss angegeben werden, bevor die Anzeige aktualisiert werden kann. |
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .
Hinweise
Diese Funktion bereitet das Zeichnen eines von lpbi angegebenen DIB für den DC vor. Das Bild wird auf die von dxDest und dyDest angegebene Größe gestreckt. Wenn dxDest und dyDest auf −1 festgelegt sind, wird der DIB ohne Dehnung auf den Maßstab 1:1 gezogen.
Sie können die Flags eines DrawDib DC aktualisieren, indem Sie DrawDibBegin neu aufstellen, die neuen Flags angeben und mindestens eine der folgenden Einstellungen ändern: dxDest, dyDest, lpbi, dxSrc oder dySrc.
Wenn sich die Parameter von DrawDibBegin nicht geändert haben, haben nachfolgende Aufrufe der Funktion keine Auswirkung.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vfw.h |
| Bibliothek | Vfw32.lib |
| DLL | Msvfw32.dll |