Struttura BITMAPINFO (wingdi.h)

Articolo
03/13/2024

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

Sintassi

typedef struct tagBITMAPINFO {
  BITMAPINFOHEADER bmiHeader;
  RGBQUAD          bmiColors[1];
} BITMAPINFO, *LPBITMAPINFO, *PBITMAPINFO;

Members

bmiHeader

Struttura BITMAPINFOHEADER che contiene informazioni sulle dimensioni del formato di colore.

bmiColors[1]

Il membro bmiColors contiene uno dei seguenti elementi:

Matrice di RGBQUAD. Elementi della matrice che costituiscono la tabella dei colori.
Matrice di interi senza segno a 16 bit che specifica gli indici nella tavolozza logica attualmente realizzata. Questo uso di bmiColors è consentito per le funzioni che usano DIB. Quando gli elementi bmiColors contengono indici a una tavolozza logica realizzata, devono anche chiamare le funzioni bitmap seguenti:
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

Il parametro iUsage di CreateDIBSection deve essere impostato su DIB_PAL_COLORS.

Il numero di voci nella matrice dipende dai valori dei membri biBitCount e biClrUsed della struttura BITMAPINFOHEADER .

I colori nella tabella bmiColors vengono visualizzati in ordine di importanza. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Un DIB è costituito da due parti distinte: una struttura BITMAPINFO che descrive le dimensioni e i colori della bitmap e una matrice di byte che definisce i pixel della bitmap. I bit nella matrice vengono compressi insieme, ma ogni riga di analisi deve essere riempita con zeri per terminare su un limite long di tipo dati. Se l'altezza della bitmap è positiva, la bitmap è un DIB inferiore e l'origine è l'angolo inferiore sinistro. Se l'altezza è negativa, la bitmap è un DIB dall'alto verso il basso e l'origine è l'angolo superiore sinistro.

Una bitmap viene compressa quando la matrice bitmap segue immediatamente l'intestazione BITMAPINFO . Le bitmap compresse fanno riferimento a un singolo puntatore. Per le bitmap compresse, il membro biClrUsed deve essere impostato su un numero pari quando si usa la modalità di DIB_PAL_COLORS in modo che la matrice bitmap DIB inizi su un limite DWORD .

Nota

Il membro bmiColors 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 abbia un uso esclusivo e il 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)