Structure BITMAPINFO (wingdi.h)
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 :
Le paramètre iUsage de CreateDIBSection doit être défini sur DIB_PAL_COLORS.
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 .
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) |