Die Leonardo-Funktion DIBFromBitmap erzeugt aus einer DDB (Device-Dependendend-Bitmap, repräsentiert durch ein HBITMAP) und der dazugehörenden Farbpalette eine DIB (Device-Independend-Bitmap, repräsentiert durch ein HDIB).
HDIB API DIBFromBitmap ( |
||
HBITMAP |
hbm, |
|
DWORD |
biStyle, |
|
WORD |
biBits, |
|
HPALETTE |
hpal); |
|
hbm |
Handle der Quell-Bitmap. |
|
Das übergebene Handle bleibt gültig. |
||
biStyle |
Sollte BI_RGB sein. |
|
biBits |
Gewünschte Farbtiefe biBitCount der DIB. |
|
0 Wie DDB |
||
1 Monochrom |
||
4 16-farbig |
||
8 256 Farben |
||
24 TrueColor |
||
hpal |
Handle einer Windows-Farbpalette das bei der Erzeugung der DDB zugrunde gelegt wurde. Dieser Parameter darf NULL sein, es wird dann die Standard-Systempalette zugrundegelegt (16 bzw. 20 Farben). |
|
Rückgabewert: |
||
Der Rückgabewert ist das Handle der erstellten DIB. 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 GlobalFree freigegeben werden. |