DaVinci 4 Grafikbibliothek Handbuch - Leonardo: Funktion CreateDIB

Selbständiger Entwickler seit 1992

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