Estructura BITMAPINFO (wingdi.h)

Artículo
03/04/2024

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

Sintaxis

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

Miembros

bmiHeader

Estructura BITMAPINFOHEADER que contiene información sobre las dimensiones del formato de color.

bmiColors[1]

El miembro imcColors contiene uno de los siguientes elementos:

Matriz de RGBQUAD. Elementos de la matriz que componen la tabla de colores.
Matriz de enteros sin signo de 16 bits que especifica índices en la paleta lógica realizada actualmente. Este uso de tbColors se permite para funciones que usan DIB. Cuando los elementos indexColors contienen índices en una paleta lógica realizada, también deben llamar a las siguientes funciones de mapa de bits:
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

El parámetro iUsage de CreateDIBSection debe establecerse en DIB_PAL_COLORS.

El número de entradas de la matriz depende de los valores de los miembros biBitCount y biClrUsed de la estructura BITMAPINFOHEADER .

Los colores de la tabla imcColors aparecen en orden de importancia. Para obtener más información, vea la sección Comentarios.

Comentarios

Una DIB consta de dos partes distintas: una estructura BITMAPINFO 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 de tipo de datos LONG . Si el alto del mapa de bits es positivo, el mapa de bits es una DIB de abajo arriba y su origen es la esquina inferior izquierda. Si el alto es negativo, el mapa de bits es una DIB de arriba abajo y su origen es la esquina superior izquierda.

Un mapa de bits se empaqueta cuando la matriz de mapa de bits sigue inmediatamente al encabezado BITMAPINFO . Se hace referencia a los mapas de bits empaquetados en un único puntero. En el caso de los mapas de bits empaquetados, el miembro biClrUsed debe establecerse en un número par cuando se usa el modo DIB_PAL_COLORS para que la matriz de mapas de bits DIB se inicie en un límite DWORD .

Nota

El miembro configColors 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 de 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)