Estrutura BITMAP (wingdi.h)

Artigo
03/04/2024

A estrutura BITMAP define os valores de tipo, largura, altura, formato de cor e bit de um bitmap.

Sintaxe

typedef struct tagBITMAP {
  LONG   bmType;
  LONG   bmWidth;
  LONG   bmHeight;
  LONG   bmWidthBytes;
  WORD   bmPlanes;
  WORD   bmBitsPixel;
  LPVOID bmBits;
} BITMAP, *PBITMAP, *NPBITMAP, *LPBITMAP;

Membros

bmType

O tipo bitmap. Esse membro deve ser zero.

bmWidth

A largura, em pixels, do bitmap. A largura deve ser maior que zero.

bmHeight

A altura, em pixels, do bitmap. A altura deve ser maior que zero.

bmWidthBytes

O número de bytes em cada linha de verificação. Esse valor deve ser divisível por 2, pois o sistema pressupõe que os valores de bit de um bitmap formam uma matriz alinhada à palavra.

bmPlanes

A contagem de planos de cores.

bmBitsPixel

O número de bits necessários para indicar a cor de um pixel.

bmBits

Um ponteiro para o local dos valores de bit para o bitmap. O membro bmBits deve ser um ponteiro para uma matriz de valores de caractere (1 byte).

Comentários

Os formatos de bitmap usados atualmente são monocromáticos e de cor. O bitmap monocromático usa um formato de um bit e um plano. Cada verificação é um múltiplo de 16 bits.

As verificações são organizadas da seguinte maneira para um bitmap monocromático de altura n:


    Scan 0 
    Scan 1 
    . 
    . 
    . 
    Scan n-2 
    Scan n-1

Os pixels em um dispositivo monocromático são preto ou branco. Se o bit correspondente no bitmap for 1, o pixel será definido como a cor de primeiro plano; se o bit correspondente no bitmap for zero, o pixel será definido como a cor da tela de fundo.

Todos os dispositivos que têm a funcionalidade do dispositivo RC_BITBLT dão suporte a bitmaps. Para obter mais informações, consulte GetDeviceCaps.

Cada dispositivo tem um formato de cor exclusivo. Para transferir um bitmap de um dispositivo para outro, use as funções GetDIBits e SetDIBits .

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)