Struttura BITMAPCOREINFO (wingdi.h)

Articolo
03/13/2024

La struttura BITMAPCOREINFO definisce le dimensioni e le informazioni sul colore per un DIB.

Sintassi

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

Members

bmciHeader

Struttura BITMAPCOREHEADER che contiene informazioni sulle dimensioni e il formato di colore di un DIB.

bmciColors[1]

Specifica una matrice di strutture RGBTRIPLE che definiscono i colori nella bitmap.

Commenti

Un DIB è costituito da due parti: una struttura BITMAPCOREINFO che descrive le dimensioni e i colori della bitmap e una matrice di byte che definiscono i pixel della bitmap. I bit nella matrice vengono raggruppati insieme, ma ogni riga di analisi deve essere riempita con zero da terminare su un limite LONG . L'origine della bitmap è l'angolo inferiore sinistro.

Il membro bcBitCount della struttura BITMAPCOREHEADER determina il numero di bit che definiscono ogni pixel e il numero massimo di colori nella bitmap. Questo membro può essere uno dei valori seguenti.

Valore	Significato
1	La bitmap è monocromatica e il membro bmciColors contiene due voci. Ogni bit nella matrice bitmap rappresenta un pixel. Se il bit è chiaro, il pixel viene visualizzato con il colore della prima voce nella tabella bmciColors ; se il bit è impostato, il pixel ha il colore della seconda voce nella tabella.
4	La bitmap ha un massimo di 16 colori e il membro bmciColors contiene fino a 16 voci. Ogni pixel nella bitmap è rappresentato da un indice a 4 bit nella tabella dei colori. Ad esempio, se il primo byte nella bitmap è 0x1F, il byte rappresenta due pixel. Il primo pixel contiene il colore nella seconda voce della tabella e il secondo pixel contiene il colore nella voce della sedicesima tabella.
8	La bitmap ha un massimo di 256 colori e il membro bmciColors contiene fino a 256 voci. In questo caso, ogni byte nella matrice rappresenta un singolo pixel.
24	La bitmap ha un massimo di 2 (24) colori e il membro bmciColors è NULL. Ogni tripletta a tre byte nella matrice bitmap rappresenta rispettivamente l'intensità relativa di blu, verde e rosso per un pixel.

I colori della tabella bmciColors devono essere visualizzati in ordine di importanza.

In alternativa, per le funzioni che usano IBS, il membro bmciColors può essere una matrice di interi senza segno a 16 bit che specificano gli indici nella tavolozza logica attualmente realizzata, anziché valori RGB espliciti. In questo caso, un'applicazione che usa la bitmap deve chiamare le funzioni DIB ( CreateDIBitmap, CreateDIBPatternBrush e CreateDIBSection ) con il parametro iUsage impostato su DIB_PAL_COLORS.

Nota

Il membro bmciColors non deve contenere indici della tavolozza se la bitmap deve essere archiviata in un file o trasferita a un'altra applicazione. A meno che l'applicazione non disponga di un uso esclusivo e del controllo della bitmap, la tabella dei colori bitmap deve contenere valori RGB espliciti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	wingdi.h (include Windows.h)