Structure BITMAPCOREINFO (wingdi.h)

Article
03/13/2024

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

Syntaxe

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

Membres

bmciHeader

Structure BITMAPCOREHEADER qui contient des informations sur les dimensions et le format de couleur d’une DIB.

bmciColors[1]

Spécifie un tableau de structures RGBTRIPLE qui définissent les couleurs dans la bitmap.

Remarques

Une DIB se compose de deux parties : une structure BITMAPCOREINFO 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 de balayage doit être remplie de zéros pour se terminer sur une limite LONG . L’origine de la bitmap est le coin inférieur gauche.

Le membre bcBitCount de la structure BITMAPCOREHEADER détermine le nombre de bits qui définissent chaque pixel et le nombre maximal de couleurs dans la bitmap. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
1	La bitmap est monochrome et le membre bmciColors contient deux entrées. Chaque bit du tableau bitmap représente un pixel. Si le bit est clair, le pixel est affiché avec la couleur de la première entrée dans la table bmciColors ; si le bit est défini, le pixel a la couleur de la deuxième entrée dans le tableau.
4	La bitmap a un maximum de 16 couleurs, et le membre bmciColors contient jusqu’à 16 entrées. Chaque pixel de la bitmap est représenté par un index 4 bits dans la table de couleurs. Par exemple, si le premier octet de la bitmap est 0x1F, l’octet représente deux pixels. Le premier pixel contient la couleur dans la deuxième entrée de tableau, et le second pixel contient la couleur dans la seizième entrée de tableau.
8	La bitmap a un maximum de 256 couleurs, et le membre bmciColors contient jusqu’à 256 entrées. Dans ce cas, chaque octet du tableau représente un seul pixel.
24	La bitmap a un maximum de 2 (24) couleurs, et le membre bmciColors est NULL. Chaque triplet de trois octets dans le tableau bitmap représente l’intensité relative du bleu, du vert et du rouge, respectivement, pour un pixel.

Les couleurs du tableau bmciColors doivent apparaître par ordre d’importance.

Sinon, pour les fonctions qui utilisent des D DIBs, le membre bmciColors peut être un tableau d’entiers non signés 16 bits qui spécifient des index dans la palette logique actuellement réalisée, au lieu de valeurs RVB explicites. Dans ce cas, une application utilisant la bitmap doit appeler les fonctions DIB ( CreateDIBitmap, CreateDIBPatternBrush et CreateDIBSection ) avec le paramètre iUsage défini sur DIB_PAL_COLORS.

Remarque

Le membre bmciColors 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)