BITMAPCOREINFO-Struktur (wingdi.h)

Artikel
03/04/2024

Die BITMAPCOREINFO-Struktur definiert die Dimensionen und Farbinformationen für einen DIB.

Syntax

typedef struct tagBITMAPCOREINFO {
  BITMAPCOREHEADER bmciHeader;
  RGBTRIPLE        bmciColors[1];
} BITMAPCOREINFO, *LPBITMAPCOREINFO, *PBITMAPCOREINFO;

Member

bmciHeader

Eine BITMAPCOREHEADER-Struktur , die Informationen zu den Abmessungen und dem Farbformat eines DIB enthält.

bmciColors[1]

Gibt ein Array von RGBTRIPLE-Strukturen an, die die Farben in der Bitmap definieren.

Hinweise

Ein DIB besteht aus zwei Teilen: einer BITMAPCOREINFO-Struktur , die die Abmessungen und Farben der Bitmap beschreibt, und einem Bytearray, das die Pixel der Bitmap definiert. Die Bits im Array werden zusammengepackt, aber jede Scanzeile muss mit Nullen aufgefüllt werden, um auf einer LONG-Grenze zu enden. Der Ursprung der Bitmap ist die untere linke Ecke.

Das bcBitCount-Element der BITMAPCOREHEADER-Struktur bestimmt die Anzahl der Bits, die jedes Pixel definieren, und die maximale Anzahl von Farben in der Bitmap. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
1	Die Bitmap ist monochrom, und das bmciColors-Element enthält zwei Einträge. Jedes Bit im Bitmaparray stellt ein Pixel dar. Wenn das Bit klar ist, wird das Pixel mit der Farbe des ersten Eintrags in der Tabelle bmciColors angezeigt. wenn das Bit festgelegt ist, hat das Pixel die Farbe des zweiten Eintrags in der Tabelle.
4	Die Bitmap hat maximal 16 Farben, und das bmciColors-Element enthält bis zu 16 Einträge. Jedes Pixel in der Bitmap wird durch einen 4-Bit-Index in der Farbtabelle dargestellt. Wenn beispielsweise das erste Byte in der Bitmap 0x1F ist, stellt das Byte zwei Pixel dar. Das erste Pixel enthält die Farbe im zweiten Tabelleneintrag, und das zweite Pixel enthält die Farbe im sechzehnten Tabelleneintrag.
8	Die Bitmap hat maximal 256 Farben, und das element bmciColors enthält bis zu 256 Einträge. In diesem Fall stellt jedes Byte im Array ein einzelnes Pixel dar.
24	Die Bitmap hat maximal 2 (24) Farben, und das bmciColors-Element ist NULL. Jedes Dreibyte-Triplet im Bitmaparray stellt die relativen Intensitäten von Blau, Grün bzw. Rot für ein Pixel dar.

Die Farben in der BmciColors-Tabelle sollten in der Reihenfolge der Wichtigkeit angezeigt werden.

Alternativ kann der bmciColors-Member für Funktionen, die DIBs verwenden, ein Array von 16-Bit-Ganzzahlen ohne Vorzeichen sein, die Indizes in die aktuell realisierte logische Palette anstelle expliziter RGB-Werte angeben. In diesem Fall muss eine Anwendung, die die Bitmap verwendet, die DIB-Funktionen ( CreateDIBitmap, CreateDIBPatternBrush und CreateDIBSection ) aufrufen, wobei der Parameter iUsage auf DIB_PAL_COLORS festgelegt ist.

Hinweis

Das bmciColors-Element sollte keine Palettenindizes enthalten, wenn die Bitmap in einer Datei gespeichert oder in eine andere Anwendung übertragen werden soll. Sofern die Anwendung die Bitmap nicht exklusiv verwendet und gesteuert hat, sollte die Bitmapfarbtabelle explizite RGB-Werte enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h (windows.h einschließen)