Funktionreferenz


_WinAPI_SetDIBits

Beschreibung anzeigen in

Setzt die Pixel in einer kompatiblen Bitmap mit den Farbdaten aus einer DIB

#include <WinAPIGdi.au3>
_WinAPI_SetDIBits ( $hDC, $hBitmap, $iStartScan, $iScanLines, $pBits, $tBMI [, $iColorUse = 0] )

Parameter

$hDC Handle zu einem Gerätekontext
$hBitmap Handle zu der kompatiblen Bitmap (DDB) welches, unter Gebrauch der Farbdaten einer DIB, verändert werden soll
$iStartScan Legt die erste einzulesende Zeile für die geräteunabhängigen Farbdaten, in dem Array auf welches der $pBits Parameter verweist, fest.
$iScanLines Legt die Anzahl der einzulesenden Zeilen, aus dem Array mit geräteunabhängigen Farbdaten, fest.
$pBits Zeiger auf die DIB Farbdaten, die in einem BYTE-Array abgelegt sind.
Das Format der Bitmapwerte hängt vom biBitCount Mitglied in der $tagBITMAPINFO Struktur ab, auf welches der $pBMI Parameter verweist.
$tBMI Eine $tagBITMAPINFO Struktur oder ein Zeiger auf diese, welche Informationen über das DIB enthält
$iColorUse [optional] Legt fest, ob das iColors Mitglied der $tagBITMAPINFO Struktur unterstützt wurde und, falls ja, ob iColors explizit rot, grün, blau (RGB) Werte enthält oder Palettenindizes.
Der $iColorUse Parameter muss einer der folgenden Werte sein:
    0 - Die Farbtabelle wird unterstützt und enthält literale RGB Werte
    1 - Die Farbtabelle setzt sich aus einem Array mit 16-bit in der logischen Palette von $hDC Indizes zusammen

Rückgabewert

Erfolg: True
Fehler: False

Bemerkungen

Der Gerätekontext, identifiziert durch den $hDC Parameter, wird nur genutzt, wenn $iColorUse auf 1 gesetzt ist, andernfalls wird er ignoriert.
Die Bitmap, identifiziert durch den hBmp Parameter, darf nicht in einen Gerätekontext eingesetzt werden, wenn diese Funktion aufgerufen wird.
Die einzulesenden Zeilen müssen nach einem DWORD ausgerichtet sein, außer für RLE komprimierte Bitmaps.
Der Anfang für von unten beginnende DIBs ist die untere-linke Ecke der Bitmap; der Anfang für von oben beginnende DIBs ist die obere-linke Ecke der Bitmap.

Verwandte Funktionen

$tagBITMAPINFO

Siehe auch

Suche nach SetDIBits in der MSDN Bibliothek.