| Herd Software Entwicklung
|= DaVinci Grafikbibliothek
|== DaVinci Dokumentation Home Search Order

Leonardo: Funktion CreateDIB

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 muß 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.