Estrutura BITMAPCOREINFO (wingdi.h)
A estrutura BITMAPCOREINFO define as dimensões e as informações de cor de um DIB.
Sintaxe
typedef struct tagBITMAPCOREINFO {
BITMAPCOREHEADER bmciHeader;
RGBTRIPLE bmciColors[1];
} BITMAPCOREINFO, *LPBITMAPCOREINFO, *PBITMAPCOREINFO;
Membros
bmciHeader
Uma estrutura BITMAPCOREHEADER que contém informações sobre as dimensões e o formato de cor de um DIB.
bmciColors[1]
Especifica uma matriz de estruturas RGBTRIPLE que definem as cores no bitmap.
Comentários
Um DIB consiste em duas partes: uma estrutura BITMAPCOREINFO que descreve as dimensões e cores do bitmap e uma matriz de bytes definindo os pixels do bitmap. Os bits na matriz são empacotados juntos, mas cada linha de verificação deve ser acolchoada com zeros para terminar em um limite LONG . A origem do bitmap é o canto inferior esquerdo.
O membro bcBitCount da estrutura BITMAPCOREHEADER determina o número de bits que definem cada pixel e o número máximo de cores no bitmap. Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
| 1 | O bitmap é monocromático e o membro bmciColors 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 bmciColors ; se o bit estiver definido, o pixel terá a cor da segunda entrada na tabela. |
| 4 | O bitmap tem no máximo 16 cores e o membro bmciColors 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 bmciColors contém até 256 entradas. Nesse caso, cada byte na matriz representa um único pixel. |
| 24 | O bitmap tem no máximo 2 (24) cores e o membro bmciColors é NULL. Cada trigêmeo de três bytes na matriz de bitmap representa as intensidades relativas de azul, verde e vermelho, respectivamente, para um pixel. |
As cores na tabela bmciColors devem aparecer em ordem de importância.
Como alternativa, para funções que usam DIBs, o membro bmciColors pode ser uma matriz de inteiros sem sinal de 16 bits que especificam índices na paleta lógica atualmente realizada, em vez de valores RGB explícitos. Nesse caso, um aplicativo que usa o bitmap deve chamar as funções DIB ( CreateDIBitmap, CreateDIBPatternBrush e CreateDIBSection ) com o parâmetro iUsage definido como DIB_PAL_COLORS.
O membro bmciColors não deve conter índices de paleta se o bitmap deve ser armazenado em um arquivo ou transferido para outro aplicativo. A menos que o aplicativo tenha uso exclusivo e controle do bitmap, a tabela de cores bitmap deve conter valores RGB explícitos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | wingdi.h (inclua Windows.h) |