Struttura BITMAP (wingdi.h)

Articolo
03/13/2024

La struttura BITMAP definisce il tipo, la larghezza, l'altezza, il formato di colore e i valori di bit di una bitmap.

Sintassi

typedef struct tagBITMAP {
  LONG   bmType;
  LONG   bmWidth;
  LONG   bmHeight;
  LONG   bmWidthBytes;
  WORD   bmPlanes;
  WORD   bmBitsPixel;
  LPVOID bmBits;
} BITMAP, *PBITMAP, *NPBITMAP, *LPBITMAP;

Members

bmType

Tipo bitmap. Questo membro deve essere zero.

bmWidth

Larghezza, in pixel, della bitmap. La larghezza deve essere maggiore di zero.

bmHeight

Altezza, in pixel, della bitmap. L'altezza deve essere maggiore di zero.

bmWidthBytes

Numero di byte in ogni riga di analisi. Questo valore deve essere divisibile per 2, perché il sistema presuppone che i valori di bit di una bitmap formino una matrice allineata a parole.

bmPlanes

Conteggio dei piani di colore.

bmBitsPixel

Numero di bit necessari per indicare il colore di un pixel.

bmBits

Puntatore alla posizione dei valori di bit per la bitmap. Il membro bmBits deve essere un puntatore a una matrice di valori di carattere (1 byte).

Commenti

I formati bitmap attualmente usati sono monocromatici e colori. La bitmap monocromatica usa un formato a un piano a un bit. Ogni analisi è un multiplo di 16 bit.

Le analisi sono organizzate come segue per una bitmap monocromatica di altezza n:


    Scan 0 
    Scan 1 
    . 
    . 
    . 
    Scan n-2 
    Scan n-1

Su un dispositivo monocromatico i pixel sono bianchi o neri. Se il bit corrispondente nella bitmap è 1, il pixel viene impostato sul colore di primo piano; se il bit corrispondente nella bitmap è zero, il pixel viene impostato sul colore di sfondo.

Tutti i dispositivi con la funzionalità del dispositivo RC_BITBLT supportano le bitmap. Per altre informazioni, vedere GetDeviceCaps.

Ogni dispositivo ha un formato di colore univoco. Per trasferire una bitmap da un dispositivo a un altro, usare le funzioni GetDIBits e SetDIBits .

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)