Structure BITMAPINFO (wingdi.h)

Article
03/13/2024

La structure BITMAPINFO définit les dimensions et les informations de couleur d’une DIB.

Syntaxe

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

Membres

bmiHeader

Structure BITMAPINFOHEADER qui contient des informations sur les dimensions du format de couleur.

bmiColors[1]

Le membre bmiColors contient l’un des éléments suivants :

Tableau de RGBQUAD. Éléments du tableau qui composent la table de couleurs.
Tableau d’entiers non signés 16 bits qui spécifie des index dans la palette logique actuellement réalisée. Cette utilisation de bmiColors est autorisée pour les fonctions qui utilisent des DIB. Lorsque les éléments bmiColors contiennent des index dans une palette logique réalisée, ils doivent également appeler les fonctions bitmap suivantes :
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

Le paramètre iUsage de CreateDIBSection doit être défini sur DIB_PAL_COLORS.

Le nombre d’entrées dans le tableau dépend des valeurs des membres biBitCount et biClrUsed de la structure BITMAPINFOHEADER .

Les couleurs de la table bmiColors apparaissent par ordre d’importance. Pour plus d'informations, consultez la section Notes.

Notes

Une DIB se compose de deux parties distinctes : une structure BITMAPINFO décrivant les dimensions et les couleurs de la bitmap, et un tableau d’octets définissant les pixels de la bitmap. Les bits du tableau sont regroupés, mais chaque ligne d’analyse doit être complétée avec des zéros pour se terminer sur une limite de type de données LONG . Si la hauteur de la bitmap est positive, la bitmap est une DIB de bas en haut et son origine est le coin inférieur gauche. Si la hauteur est négative, la bitmap est une DIB supérieure vers le bas et son origine est le coin supérieur gauche.

Une image bitmap est empaquetée lorsque le tableau bitmap suit immédiatement l’en-tête BITMAPINFO . Les bitmaps empaquetées sont référencées par un pointeur unique. Pour les bitmaps empaquetées, le membre biClrUsed doit être défini sur un nombre pair lors de l’utilisation du mode DIB_PAL_COLORS afin que le tableau bitmap DIB démarre sur une limite DWORD .

Remarque

Le membre bmiColors ne doit pas contenir d’index de palette si la bitmap doit être stockée dans un fichier ou transférée vers une autre application.

À moins que l’application ne dispose d’une utilisation et d’un contrôle exclusifs de la bitmap, la table de couleurs bitmap doit contenir des valeurs RVB explicites.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	wingdi.h (inclure Windows.h)