CreateDIB erzeugt eine leere (schwarze) DIB mit der angegebenen Größe und Farbtiefe. Es wird eine globales Speicherhandle erstellt, das einen BITMAPINFOHEADER und eine Standard-Palette enthält, die Bitmap-Daten der DIB bleiben leer.
Bei DIBs mit 8 Bit Farbtiefe wird nur eine VGA-Farbpalette mit 16 Farben vorbereitet.
HDIB API CreateDIB( |
||
UINT |
Width, |
|
UINT |
Height, |
|
UINT |
BitCount, |
|
DWORD |
Flags); |
Width |
UINT |
Breite der neuen DIB in Pixeln |
Height |
UINT |
Höhe der neuen DIB in Pixeln |
BitCount |
UINT |
Farbtiefe der neuen DIB: |
1 - Monochrom |
||
4 - 16 Farben |
||
8 - 256 Farben |
||
16 - HighColor 5,5,5 |
||
24 - TrueColor |
||
32 TrueColor |
||
Flags |
DWORD |
CREATEDIB_ZEROINIT Die Bits der DIB werden mit 0 (Schwarz) initialisiert |
CREATEDIB_NOZERINIT Die Bits der DIB werden nicht initialisiert und enthalten zufällige Werte |
||
Rückgabewert: |
||
Der Rückgabewert gibt das Handle der DIB an. Das Handle muss von der Applikation mit der Funktion GlobalFree wieder freigegeben werden. |
||
Hinweise: |
||
Da die Funktion CreateDIB keine Steuerung der Farbpalette zuläßt, ist die Funktion CreateCompatibeDIB im allgemeinen vorzuziehen, sofern sie anwendbar ist. |