StretchBlt

von ActiveVB-Team

Deklaration

Declare Function StretchBlt Lib "gdi32" ( _
                 ByVal hdc As Long, _
                 ByVal x As Long, _
                 ByVal y As Long, _
                 ByVal nWidth As Long, _
                 ByVal nHeight As Long, _
                 ByVal hSrcDC As Long, _
                 ByVal xSrc As Long, _
                 ByVal ySrc As Long, _
                 ByVal nSrcWidth As Long, _
                 ByVal nSrcHeight As Long, _
                 ByVal dwRop As Long) As Long

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

StretchBlt kopiert eine Bitmap aus einem quellrechteck in ein Zielrechteck, wobei gegebenenfalls eine Vergrößerung oder Verkleinerung gemäß dem aktuellen Vergrößerungsmodus durchgeführt wird. Das Bild kann unter Verwendung entgegengesetzter Vorzeichen für Breiten- und Höhenparameter von Quelle und Ziel invertiert oder umgedreht werden.

Diese Funktion ist gut geeignet für Fenster deren Größe verändert werden kann, aber möglicherweise ist es auch notwendig eine Bitmap zu verändern, abhängig von der Fenstergröße. Starke Vergrößerungen von Bitmaps resultieren in ausgefransten Kanten. Für größere Bilder sollten Sie Metadateien in Betracht ziehen.

Parameter
hDC	Der Ziel-Gerätekontext.
x	Die x-Koordinate der linken oberen Ecke des Zielrechtecks, angegeben in logischen Einheiten.
y	Die y-Koordinate der linken oberen Ecke des Zielrechtecks, angegeben in logischen Einheiten.
nWidth	Die Breite des Zielrechtecks, angegeben in logischen Einheiten.
nHeight	Die Höhe des Zielrechtecks, angegeben in logischen Einheiten.
xSrc	Die x-Koordinate der linken oberen Ecke des Quell-Rechtecks, angegeben in logischen Einheiten.
ySrc	Die x-Koordinate der linken oberen Ecke des Quell-Rechtecks, angegeben in logischen Einheiten.
nSrcWidth	Die Breite des Quellrechtecks, angegeben in logischen Einheiten.
nSrcHeight	Die Höhe des Quellrechtecks, angegeben in logischen Einheiten.
dwRop	Der Raster-Operationscode. 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
SetStretchBltMode, GetDeviceCaps, BitBlt

Zugehörige Tipps

Bildauschnitt mit API zoomen [Tipp 0069]
Screenshot, Fotografie des Bildschirms erstellen [Tipp 0078]
Bitmap um alle Achsen spiegeln [Tipp 0092]
Überblendeffekte mit Bitmaps [Tipp 0371]
Bildschirmlupe mit StretchBlt realisieren [Tipp 0443]
Mit DirectX ein Bild gestreckt auf eine Form blitten [Tipp 0446]
FPS - Frames pro Sekunde ermitteln [Tipp 0452]

Zugehörige Microsoft Knowledge Base Artikel

HOWTO: Save the Client Area of a Visual Basic Form to a DIB Section