Die Leonardo-Funktion BitmapFromDIB erzeugt eine DDB (Device-Dependendend-Bitmap, repräsentiert durch ein HBITMAP) aus einer DIB (Device-Independend-Bitmap, repräsentiert durch ein HDIB).
HBITMAP WINAPI BitmapFromDIB( |
||
HDIB |
hDIB |
|
HPALETTE |
hpal); |
|
hDIB |
Handle der Quell-DIB. Es darf sich um eine DIB mit 1,4,8 oder 24 Bit Farbtiefe handeln. |
|
Das übergebene Handle bleibt gültig. |
||
hpal |
Handle einer Windows-Farbpalette das bei der Erzeugung der DDB zugrunde gelegt werden soll, z.B. erzeugt durch die Funktion CreateDibPalette. |
|
Dieser Parameter darf NULL sein, es wird dann die Standard-Systempalette zugrunde gelegt (16 bzw. 20 Farben). |
||
Die durch die Funktion BitmapFromDib erstellte DDB darf nur gemeinsam mit der bei der Erstellung benutzen Palette benutzt werden, beider Objekte sind zwar voneinander unabhängig gespeichert, ergänzen sich aber erst gemeinsam zu einem fehlerfreien Bild. |
||
Siehe auch: SelectPalette. |
||
Rückgabewert: |
||
Der Rückgabewert ist das Handle der erstellten Bitmap. Er ist NULL, wenn die Umwandlung erfolglos war, die Ursache ist dann meist mangelnder Hauptspeicher. Das Bitmap-Handle muss von der Applikation mit der Funktion DeleteObject freigegeben werden. |