_WinAPI_GetDIBits
Beschreibung anzeigen in
Ermittelt die Bits einer bestimmten Bitmap und kopiert diese in einen Speicherpuffer als DIB
#include <WinAPIGdi.au3>
_WinAPI_GetDIBits ( $hDC, $hBitmap, $iStartScan, $iScanLines, $pBits, $tBI, $iUsage )
Parameter
| $hDC | Handle zum Gerätekontext |
| $hBitmap | Handle zur Bitmap. Dieses muss eine kompatible Bitmap sein (DDB). |
| $iStartScan | Legt die erste einzulesende Zeile fest die ermittelt werden soll |
| $iScanLines | Legt die Anzahl der einzulesenden Zeilen fest |
| $pBits | Zeiger auf einen Puffer der die Daten aufnimmt. Ist dieser Parameter 0, leitet die Funktion die Dimensionen und das Format der Bitmap zu der $tagBITMAPINFO Struktur auf die der Zeiger des pBI Parameters verweist. |
| $tBI | eine $tagBITMAPINFO Struktur oder ein Zeiger auf diese, welche das gewünschte Format der DIB Daten festlegt |
| $iUsage | Legt das Format für das bmiColors Strukturmitglied in der $tagBITMAPINFO Struktur fest. Dieses muss einer folgenden Werte sein: $DIB_PAL_COLORS - Die Farbtabelle soll aus einem Array von 16-Bit-Indizes in der aktuellen (logischen) Palette bestehen $DIB_RGB_COLORS - Die Farbtabelle soll aus literalen Rot, Grün, Blau (RGB) Werten bestehen |
Rückgabewert
| Erfolg: | Ist $pBits ungleich 0 und die Funktion kehrt erfolgreich zurück, ist der Rückgabewert die Anzahl der eingelesenen Zeilen, die aus der Bitmap kopiert wurden. Ist $pBits 0 und GetDIBits füllt erfolgreich die Struktur, ist der Rückgabewert TRUE. |
| Fehler: | False |
Verwandte Funktionen
Siehe auch
Suche nach GetDIBits in der MSDN Bibliothek.