SetStretchBltMode
von ActiveVB-Team
Deklaration
Declare Function SetStretchBltMode Lib "gdi32" ( _ ByVal hdc As Long, _ ByVal nStretchMode As Long) As LongWeitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel SetStretchBltMode des API-Wikis.
SetStretchBltMode setzt den Vergrößerungsmodus für die Bitmap eines Gerätekontextes. Der Vergrößerungsmodus legt fest, wie Pixel entfernt werden, wenn eine Bitmap verkleinert werden soll. Bitmaps, die vergrößert werden, fügen einfach passende Pixel zwischen die bereits bestehenden ein. Der Vergrößerungsmodus ist eine Eigenschaft des Gerätekontextes und bleibt gültig, bis er Gerätekontext gelöscht oder ein neuer Vergrößerungsmodus gesetzt wird.
Welcher Vergrößerungsmodus der jeweils beste ist, hängt von der zu verkleinernden Bitmap ab. Bilder mit wenigen dünnen Zeilen, werden am effektivsten durch STRETCH_ANDSCANS , Bilder mit wenigen dicken Zeilen am besten mit STRETCH_ORSCANS verarbeitet. Allgemeine Farbbilder verwenden STRETCH_DELETESCANS .
Parameter | |
---|---|
hDC | Der gewünschte Gerätekontext. |
nStretchMode | Der neue Vergrößerungsmodus. Dabei kann es sich um einen der unten aufgelisteten Werte handeln. |
Tabelle 1
Vergrößerungswerte für nStretchMode | |
---|---|
STRETCH_ANDSCANS | Führt ein boolisches UND dür die Darbwerte der zu eliminierenden und der existierenden Pixels durch. Wenn es sich um eine Schwarzweiß-Bitmap handelt, werden schwarze Pixel bevorzugt. Dieser Wert ist auch als BLACKONWHITE definiert. |
STRETCH_DELETESCANS | Löscht die Pixel. Dieser Modus löscht alle eleminierten Pixelzeilen, ohne zu versuchen, ihre Information beizubehalten. Dieser Wert ist auch als COLORONCOLOR definert. |
STRETCH_ORSCANS | Führt ein boolesches ODER für die Farbwerte der zu eliminierenden und der existierenden Pixels durch. Wenn es sich um eine Schwarzweiß-Bitmap handelt, werden die weißen Pixel bevorzugt. Dieser Wert ist auch als WHITEONBLACK definiert. |
STRETCH_HALFTONE | Bildet Pixel vom Quell-Rechteck in Blöcken auf das Ziel-Rechteck ab. Die durchschnittliche Farbe im Zielblock stellt annähernd die Farbe der Quellpixel dar. Dieser Wert ist auch als HALFTONE defniert. Nachdem der Vergrößerungsmodus STRETCH_HALFTONE gesetzt wurde, muß eine Anwendung die Funktion SetBrushOrgEx aufrufen, um den Ursprung für den Pinsel zu setzen, andernfalls wird diese fehlerhaft ausgeführt. |
Tabelle 2
Rückgabewerte | |
---|---|
LONG | Der vorherige Vergrößerungsmodus |
0 | Es lag ein Fehler vor. |
Tabelle 3
Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
GetStretchBltMode, StretchBlt
Zugehörige Tipps