BITMAP 結構 (wingdi.h)

發行項
03/04/2024

BITMAP 結構會定義點陣圖的類型、寬度、高度、色彩格式和位值。

語法

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

成員

bmType

點陣圖類型。這個成員必須是零。

bmWidth

位圖的寬度，以像素為單位。寬度必須大於零。

bmHeight

位圖的高度，以像素為單位。高度必須大於零。

bmWidthBytes

每個掃描行中的位元組數目。此值必須以 2 分隔，因為系統會假設位陣圖的位值形成對齊字組的數位。

bmPlanes

色彩平面的計數。

bmBitsPixel

指出圖元色彩所需的位數。

bmBits

點陣圖之位值位置的指標。 bmBits 成員必須是字元陣列的指標， (1 位元組) 值。

備註

目前使用的點陣圖格式為單色和色彩。單色位圖使用一位單平面格式。每個掃描的位元組皆為 16 的倍數。

掃描會依照下列方式組織，以取得高度 n 的單色位圖：


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

在單色裝置上的像素不是黑色就是白色。如果點圖中的對應位為 1，像素會設定為前景色彩;如果點圖中的對應位為零，圖元會設定為背景色彩。

具有RC_BITBLT裝置功能的所有裝置都支援位圖。如需詳細資訊，請參閱 GetDeviceCaps。

每個裝置都有唯一的色彩格式。若要將點陣圖從一個裝置傳輸到另一個裝置，請使用 GetDIBits 和 SetDIBits 函式。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	wingdi.h (包含 Windows.h)