Estructura BITMAPCOREINFO (wingdi.h)

Artículo
03/08/2023

La estructura BITMAPCOREINFO define las dimensiones y la información de color de una DIB.

Sintaxis

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

Miembros

bmciHeader

Estructura BITMAPCOREHEADER que contiene información sobre las dimensiones y el formato de color de una DIB.

bmciColors[1]

Especifica una matriz de estructuras RGBTRIPLE que definen los colores en el mapa de bits.

Comentarios

Una DIB consta de dos partes: una estructura BITMAPCOREINFO que describe las dimensiones y los colores del mapa de bits, y una matriz de bytes que define los píxeles del mapa de bits. Los bits de la matriz se empaquetan juntos, pero cada línea de examen debe rellenarse con ceros para finalizar en un límite LONG . El origen del mapa de bits es la esquina inferior izquierda.

El miembro bcBitCount de la estructura BITMAPCOREHEADER determina el número de bits que definen cada píxel y el número máximo de colores en el mapa de bits. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
1	El mapa de bits es monocromo y el miembro bmciColors contiene dos entradas. Cada bit de la matriz de mapa de bits representa un píxel. Si el bit está claro, el píxel se muestra con el color de la primera entrada en la tabla bmciColors ; si se establece el bit, el píxel tiene el color de la segunda entrada de la tabla.
4	El mapa de bits tiene un máximo de 16 colores y el miembro bmciColors contiene hasta 16 entradas. Cada píxel del mapa de bits se representa mediante un índice de 4 bits en la tabla de colores. Por ejemplo, si el primer byte del mapa de bits es 0x1F, el byte representa dos píxeles. El primer píxel contiene el color de la segunda entrada de tabla y el segundo píxel contiene el color de la entrada de la tabla decimosexta.
8	El mapa de bits tiene un máximo de 256 colores y el miembro bmciColors contiene hasta 256 entradas. En este caso, cada byte de la matriz representa un solo píxel.
24	El mapa de bits tiene un máximo de 2 (24) colores y el miembro bmciColors es NULL. Cada triplete de tres bytes de la matriz de mapa de bits representa las densidades relativas de azul, verde y rojo, respectivamente, para un píxel.

Los colores de la tabla bmciColors deben aparecer en orden de importancia.

Como alternativa, para las funciones que usan DIB, el miembro bmciColors puede ser una matriz de enteros sin signo de 16 bits que especifican índices en la paleta lógica realizada actualmente, en lugar de valores RGB explícitos. En este caso, una aplicación que use el mapa de bits debe llamar a las funciones DIB ( CreateDIBitmap, CreateDIBPatternBrush y CreateDIBSection ) con el parámetro iUsage establecido en DIB_PAL_COLORS.

Nota

El miembro bmciColors no debe contener índices de paleta si el mapa de bits se va a almacenar en un archivo o transferirse a otra aplicación. A menos que la aplicación tenga un uso exclusivo y control del mapa de bits, la tabla de colores del mapa de bits debe contener valores RGB explícitos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wingdi.h (incluye Windows.h)