BitBlt

von ActiveVB-Team

Deklaration

Declare Function BitBlt Lib "gdi32" ( _
                 ByVal hDCDest As Long, _
                 ByVal XDest As Long, _
                 ByVal YDest As Long, _
                 ByVal nWidth As Long, _
                 ByVal nHeight As Long, _
                 ByVal hDCSrc As Long, _
                 ByVal XSrc As Long, _
                 ByVal YSrc As Long, _
                 ByVal dwRop As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel BitBlt des API-Wikis.

BitBlt ist die Standardfunktion für die Anzeige von Bitmaps. Sie kopiert eine Bitmap aus einem Speicher-Gerätekontext in einen anderen Gerätekontext, etwa in den eines Fensters. Die Bitmap muß zunächst in einem Speicher-Gerätekontext selektiert werden, der mit CreateCompatibleDC erzeugt wird.

Die Bitmap kann unter Verwendung der Rasteroperationen mit dem existierenden Hintergrund kombiniert werden. Nicht alle Geräte unterstützen BitBlt. Anhand des RASTERCAPS-Rückgabewerts aus der Funktion GetDeviceCaps können Sie feststellen, ob BitBlt-Operationen unterstützt werden.

Parameter
hDCDest	HDC: Der Gerätekontext-Handle für die Bitmap
XDest	Die logische x-Koordinate der oberen linken Ecke des Ziel-Rechtecks
YDest	Die logische y-Koordinate der oberen linken Ecke des Ziel-Rechtecks
nWidth	Die Breite des Quell- und Zielrechtecks, angegeben in logischen Einheiten
nHeight	Die Höhe des Quell- und Zielrechtecks, angegeben in logischen Einheiten
hDCSrc	DerGerätekontext aus dem die Bitmap kopiert wird. Dabei handelt es sich normalerweise um ein Speicher-Gerätekontext, der mit CreateCompatibleDC erzeugt wurde.
XSrc	Die logische x-Koordinate der oberen linken Ecke des Quell-Rechtecks
YSrc	Die logische y-Koordinate der oberen linken Ecke des Quell-Rechtecks
dwRop	Der Raster-Operationscode. Diese Codes definieren, wie die Farbdaten des Quell-Rechtecks kombiniert werden, um die endgültige Farbe zu erhalten. Untenstehende Tabelle zeigt einige der gebräuchlisten Raster-Operationscodes

Tabelle 1

Gängige Rasteroperationscodes [ROPs] für dwRop
BLACKNESS	Setzt alle Ausgaben auf die Farb, die in der physikalischen Palette den Index 0 hat (für die Standardpalette ist das schwarz)
DSTINVERT	Invertiert das Zielrechteck
MERGECOPY	Die Quell- und Ziel-Bitmaps werden durch das Boolesche UND verknüpft.
MERGEPAINT	Die Quell- und Ziel-Bitmaps werden durch das Boolesche ODER verknüpft.
NOTSRCCOPY	Invertiert die Quellbitmap und kopiert sie dann aufs Ziel
NOTSRCERASE	Invertiert das Ergebnis der Kombination von Quell- und Zielbitmap unter Verwendung der booleschen ODER.
PATCOPY	Kopiert ein Muster aufs Ziel
PATINVERT	Kombiniert die Ziel-Bitmap unter Verwendung des booleschen XODER mit dem Muster
PATPAINT	Kombiniert die Farben des Musters mit den Farben des invertierten des invertierten Quellrechtecks, wozu der boolesche ODER-Operator verwendet wird. Das ERgebnis wird mit den Farben der Zielbitmap kombiniert, ebenfalss durch das boolesche ODER
SRCAND	Kombiniert die Quell- und Zielbitmaps mit dem booleschen UND
SRCCOPY	Kopiert die Quelle direkt auf das Ziel
SRCERASE	Kombiniert die invertierten Farben der Ziel-Bitmap mit den Farben der Quell-Bitmap, wozu das boolesche UND verwendet wird
SRCINVERT	Kombiniert die Quell- und Zielbitmaps mit dem booleschen XODER
SRCPAINT	Kombiniert die Quell- und Zielbitmaps mit dem booleschen ODER
SRCWHITENESS	Setzt die Ausgabe auf die Farbe, der in der physikalischen Palette der Index 1 zugeordnet ist (für die Standardpalette ist dies Weiß)

Tabelle 2

Rückgabewerte
TRUE	Falls die Funktion erfolgreich ausgeführt werden konnte
FALSE	Es gab Fehler und die Funktion wurde nicht ausgeführt

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateCompatibleDC, DeleteObject, LoadBitmap, SelectObject, GetDeviceCaps

Zugehörige Tipps

Masken für transparente Bitmaps erstellen [Tipp 0112]
Grafik flackerfrei animieren und bewegen [Tipp 0113]
Bitmap transparent in eine andere Grafik einbinden [Tipp 0114]
Auf dem Desktop mit GDI-Werkzeugen zeichnen [Tipp 0125]
Farbe des Pixels unter der Maus auf dem ganzen Bildschirm [Tipp 0158]
Bitmaps und Grafiken in der Titelleiste [Tipp 0163]
Bitmap invertieren [Tipp 0167]
8-Bit-Bitmaps drehen, rotieren [Tipp 0222]
24-Bit-Bitmaps rotieren und zoomen [Tipp 0223]
VB-Blur Demo [Tipp 0243]
Helligkeit und Kontrast einer 24-Bit Bitmap ändern [Tipp 0253]
Emboss-Effekt auf eine 24-Bit-Bitmap anwenden [Tipp 0254]
RGB-Farbanteile einer 24-Bit-Bitmap manipulieren [Tipp 0255]
Ripple-Effekt auf eine 24-Bit-Bitmap anwenden [Tipp 0256]
Optisches Schärfen einer 24-Bit-Bitmap [Tipp 0257]
Gezielten Snapshot erstellen [Tipp 0311]
ListBox mit Grafiken, ownerdrawn [Tipp 0325]
Komplexe Regions erzeugen [Tipp 0370]
Überblendeffekte mit Bitmaps [Tipp 0371]
Hintergründe von Forms und PictureBoxen mit Grafiken kacheln [Tipp 0372]
Zeichnen im DC einer fremden Anwendung [Tipp 0430]
Schnelle grafische Operationen mit DIBs [Tipp 0431]
Bildschirmlupe mit StretchBlt realisieren [Tipp 0443]
Mit DirectX ein Bild gestreckt auf eine Form blitten [Tipp 0446]
Form-Regions anhand einer Bitmap erstellen [Tipp 0470]
Unterwasser-Effekt [Tipp 0494]
Bilder per Winsock übertragen [Tipp 0741]

Zugehörige Microsoft Knowledge Base Artikel