estructura de _BITMAPINFOHEADER

La estructura _BITMAPINFOHEADER define el formato de un fotograma de vídeo.

Sintaxis

typedef struct _tagBITMAPINFOHEADER {
  DWORD biSize;
  LONG  biWidth;
  LONG  biHeight;
  WORD  biPlanes;
  WORD  biBitCount;
  DWORD biCompression;
  DWORD biSizeImage;
  LONG  biXPelsPerMeter;
  LONG  biYPelsPerMeter;
  DWORD biClrUsed;
  DWORD biClrImportant;
} _BITMAPINFOHEADER;

Miembros

biSize

Especifica el número de bytes requeridos por la estructura.

biWidth

Especifica el ancho del mapa de bits, en píxeles.

biHeight

Especifica el alto del mapa de bits, en píxeles. Si biHeight es positivo, el mapa de bits es un DIB de abajo arriba y su origen es la esquina inferior izquierda. Si biHeight es negativo, el mapa de bits es un DIB de arriba abajo y su origen es la esquina superior izquierda. Si biHeight es negativo, lo que indica una DIB de arriba abajo, biCompression debe ser BI_RGB o BI_BITFIELDS. Las DIB de arriba abajo no se pueden comprimir.

Biplanos

Especifica el número de planos para el dispositivo de destino. Este valor debe establecerse en 1.

biBitCount

Especifica el número de bits por píxel. El miembro biBitCount de la estructura BITMAPINFOHEADER 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 debe ser uno de los valores siguientes.

Valor	Descripción
1	El mapa de bits es monocromo y el miembro imcColors 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 de imcColors; si se establece el bit, el píxel tiene el color de la segunda entrada de la tabla.
2	El mapa de bits tiene cuatro valores de color posibles.
4	El mapa de bits tiene un máximo de 16 colores, y el miembro configColors 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 configColors contiene hasta 256 entradas. En este caso, cada byte de la matriz representa un solo píxel.
16	El mapa de bits tiene un máximo de 2^16 colores. Si el miembro biCompression del BITMAPINFOHEADER es BI_RGB, el miembro indexColors es NULL. Cada WORD de la matriz de mapa de bits representa un solo píxel. Las densidades relativas de rojo, verde y azul se representan con 5 bits para cada componente de color. El valor de blue está en los 5 bits menos significativos, seguido de 5 bits cada uno para verde y rojo. No se usa el bit más significativo. La tabla de colores de imcColors se usa para optimizar los colores usados en dispositivos basados en paletas y debe contener el número de entradas especificadas por el miembro biClrUsed.
24	El mapa de bits tiene un máximo de 2^24 colores y el miembro imcColors es NULL. Cada triple de 3 bytes de la matriz de mapa de bits representa las densidades relativas de azul, verde y rojo, respectivamente, para un píxel. La tabla de colores de imcColors se usa para optimizar los colores usados en dispositivos basados en paletas y debe contener el número de entradas especificadas por el miembro biClrUsed.
32	El mapa de bits tiene un máximo de 2^32 colores. Si el miembro biCompression es BI_RGB, el miembro de imcColors es NULL. Cada DWORD de la matriz de mapa de bits representa las densidades relativas de azul, verde y rojo, respectivamente, para un píxel. No se usa el byte alto de cada DWORD. La tabla de colores de imcColors se usa para optimizar los colores usados en dispositivos basados en paletas y debe contener el número de entradas especificadas por el miembro biClrUsed.

biCompression

Especifica el tipo de compresión de un mapa de bits inferior comprimido (no se pueden comprimir los DIB de arriba abajo). Este miembro puede ser uno de los valores siguientes.

Valor	Descripción
BI_RGB	Un formato sin comprimir.
BI_BITFIELDS	Especifica que el mapa de bits no está comprimido y que la tabla de colores consta de tres máscaras de color DWORD que especifican los componentes rojo, verde y azul, respectivamente, de cada píxel. Esto es válido cuando se usa con mapas de bits de 16 bpp y 32 bpp. Este valor es válido en Microsoft Windows CE versión 2.0 y posteriores.

biSizeImage

Especifica el tamaño de la imagen, en bytes. Esto puede establecerse en cero para BI_RGB mapas de bits.

biXPelsPerMeter

Especifica la resolución horizontal, en píxeles por medidor, del dispositivo de destino para el mapa de bits. Una aplicación puede usar este valor para seleccionar un mapa de bits de un grupo de recursos que mejor coincida con las características del dispositivo actual.

biYPelsPerMeter

Especifica la resolución vertical, en píxeles por medidor, del dispositivo de destino para el mapa de bits.

biClrUsed

Especifica el número de índices de color de la tabla de colores que realmente usa el mapa de bits. Si este valor es cero, el mapa de bits usa el número máximo de colores correspondientes al valor del miembro biBitCount para el modo de compresión especificado por biCompression.

biClrImportant

Especifica el número de índices de color necesarios para mostrar el mapa de bits. Si este valor es cero, se requieren todos los colores.

Si biClrUsed es distinto de cero y el miembro biBitCount es menor que 16, el miembro biClrUsed especifica el número real de colores a los que accede el motor gráfico o el controlador de dispositivo. Si biBitCount es 16 o superior, el miembro biClrUsed especifica el tamaño de la tabla de colores utilizada para optimizar el rendimiento de las paletas de colores del sistema. Si biBitCount es igual a 16 o 32, la paleta de colores óptima comienza inmediatamente después de las tres máscaras DWORD.

Si el mapa de bits es un mapa de bits empaquetado (un mapa de bits en el que la matriz de mapa de bits sigue inmediatamente la estructura _BITMAPINFOHEADER y se hace referencia a ella mediante un único puntero), el miembro biClrUsed debe ser cero o el tamaño real de la tabla de colores.

Comentarios

Esta estructura se encuentra dentro de una estructura de _VIDEOINFOHEADER .

Requisitos

Requisito	Value
Encabezado	Wmdm.idl

Consulte también

Estructuras

_VIDEOINFOHEADER