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

Weitere Informationen

DrawDib-Funktionen