estrutura _BITMAPINFOHEADER
A estrutura _BITMAPINFOHEADER define o formato de um quadro de vídeo.
Sintaxe
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;
Membros
-
biSize
-
Especifica o número de bytes exigidos pela estrutura.
-
Biwidth
-
Especifica a largura do bitmap, em pixels.
-
Biheight
-
Especifica a altura do bitmap, em pixels. Se biHeight for positivo, o bitmap será um DIB de baixo para cima e sua origem será o canto inferior esquerdo. Se biHeight for negativo, o bitmap será um DIB de cima para baixo e sua origem será o canto superior esquerdo. Se biHeight for negativo, indicando um DIB de cima para baixo, biCompression deverá ser BI_RGB ou BI_BITFIELDS. DiBs de cima para baixo não podem ser compactados.
-
Biplanos
-
Especifica o número de planos para o dispositivo de destino. Esse valor deve ser definido como 1.
-
Bibitcount
-
Especifica o número de bits por pixel. O membro biBitCount da estrutura BITMAPINFOHEADER determina o número de bits que definem cada pixel e o número máximo de cores no bitmap. Esse membro deve ser um dos valores a seguir.
Valor Descrição 1 O bitmap é monocromático e o membro bmiColors contém duas entradas. Cada bit na matriz de bitmap representa um pixel. Se o bit estiver claro, o pixel será exibido com a cor da primeira entrada na tabela bmiColors; se o bit estiver definido, o pixel terá a cor da segunda entrada na tabela. 2 O bitmap tem quatro valores de cor possíveis. 4 O bitmap tem no máximo 16 cores e o membro bmiColors contém até 16 entradas. Cada pixel no bitmap é representado por um índice de 4 bits na tabela de cores. Por exemplo, se o primeiro byte no bitmap for 0x1F, o byte representará dois pixels. O primeiro pixel contém a cor na segunda entrada de tabela e o segundo pixel contém a cor na décima sexta entrada de tabela. 8 O bitmap tem no máximo 256 cores e o membro bmiColors contém até 256 entradas. Nesse caso, cada byte na matriz representa um único pixel. 16 O bitmap tem no máximo 2^16 cores. Se o membro biCompression do BITMAPINFOHEADER for BI_RGB, o membro bmiColors será NULL. Cada WORD na matriz de bitmap representa um único pixel. As intensidades relativas de vermelho, verde e azul são representadas com 5 bits para cada componente de cor. O valor para azul está nos 5 bits menos significativos, seguido por 5 bits cada para verde e vermelho. O bit mais significativo não é usado. A tabela de cores bmiColors é usada para otimizar as cores usadas em dispositivos baseados em paleta e deve conter o número de entradas especificadas pelo membro biClrUsed. 24 O bitmap tem no máximo 2^24 cores e o membro bmiColors é NULL. Cada trigêmeo de 3 bytes na matriz de bitmap representa as intensidades relativas de azul, verde e vermelho, respectivamente, para um pixel. A tabela de cores bmiColors é usada para otimizar as cores usadas em dispositivos baseados em paleta e deve conter o número de entradas especificadas pelo membro biClrUsed. 32 O bitmap tem no máximo 2^32 cores. Se o membro biCompression for BI_RGB, o membro bmiColors será NULL. Cada DWORD na matriz de bitmap representa as intensidades relativas de azul, verde e vermelho, respectivamente, para um pixel. O byte alto em cada DWORD não é usado. A tabela de cores bmiColors é usada para otimizar as cores usadas em dispositivos baseados em paleta e deve conter o número de entradas especificadas pelo membro biClrUsed. -
Bicompression
-
Especifica o tipo de compactação para um bitmap compactado de baixo para cima (DIBs de cima para baixo não podem ser compactados). Esse membro pode ser um dos valores a seguir.
Valor Descrição BI_RGB Um formato descompactado. BI_BITFIELDS Especifica que o bitmap não é compactado e que a tabela de cores consiste em três máscaras de cores DWORD que especificam os componentes vermelho, verde e azul, respectivamente, de cada pixel. Isso é válido quando usado com bitmaps de 16 bpp e 32 bpp. Esse valor é válido no Microsoft Windows CE versão 2.0 e posterior. -
biSizeImage
-
Especifica o tamanho da imagem, em bytes. Isso pode ser definido como zero para BI_RGB bitmaps.
-
biXPelsPerMeter
-
Especifica a resolução horizontal, em pixels por medidor, do dispositivo de destino para o bitmap. Um aplicativo pode usar esse valor para selecionar um bitmap de um grupo de recursos que melhor corresponda às características do dispositivo atual.
-
biYPelsPerMeter
-
Especifica a resolução vertical, em pixels por medidor, do dispositivo de destino para o bitmap.
-
Biclrused
-
Especifica o número de índices de cores na tabela de cores que são realmente usados pelo bitmap. Se esse valor for zero, o bitmap usará o número máximo de cores correspondente ao valor do membro biBitCount para o modo de compactação especificado por biCompression.
-
biClrImportant
-
Especifica o número de índices de cores necessários para exibir o bitmap. Se esse valor for zero, todas as cores serão necessárias.
Se biClrUsed não for zero e o membro biBitCount for menor que 16, o membro biClrUsed especificará o número real de cores que o mecanismo gráfico ou o driver de dispositivo acessa. Se biBitCount for 16 ou superior, o membro biClrUsed especificará o tamanho da tabela de cores usada para otimizar o desempenho das paletas de cores do sistema. Se biBitCount for igual a 16 ou 32, a paleta de cores ideal começará imediatamente após as três máscaras DWORD.
Se o bitmap for um bitmap empacotado (um bitmap no qual a matriz de bitmap segue imediatamente a estrutura _BITMAPINFOHEADER e é referenciada por um único ponteiro), o membro biClrUsed deve ser zero ou o tamanho real da tabela de cores.
Comentários
Essa estrutura está contida em uma estrutura de _VIDEOINFOHEADER .
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|