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] )
$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 |
Erfolg: | True |
Fehler: | False |
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.
Suche nach SetDIBits in der MSDN Bibliothek.