BITMAPCOREINFO 结构 (wingdi.h)

项目
03/09/2024

BITMAPCOREINFO 结构定义 DIB 的尺寸和颜色信息。

语法

typedef struct tagBITMAPCOREINFO {
  BITMAPCOREHEADER bmciHeader;
  RGBTRIPLE        bmciColors[1];
} BITMAPCOREINFO, *LPBITMAPCOREINFO, *PBITMAPCOREINFO;

成员

bmciHeader

BITMAPCOREHEADER 结构，包含有关 DIB 的尺寸和颜色格式的信息。

bmciColors[1]

指定用于定义位图中颜色的 RGBTRIPLE 结构的数组。

注解

DIB 由两部分组成：描述位图的尺寸和颜色的 BITMAPCOREINFO 结构，以及定义位图像素的字节数组。数组中的位打包在一起，但每个扫描行都必须用零填充才能在 LONG 边界上结束。位图的原点为左下角。

BITMAPCOREHEADER 结构的 bcBitCount 成员确定定义每个像素的位数以及位图中颜色的最大数目。此成员可以是以下值之一。

值	含义
1	位图为单色， bmciColors 成员包含两个条目。位图数组中的每个位表示一个像素。如果位是清除的，则像素以 bmciColors 表中第一个条目的颜色显示;如果设置了位，则像素具有表中第二个条目的颜色。
4	位图最多包含 16 种颜色， bmciColors 成员最多包含 16 个条目。位图中的每个像素都由颜色表中的 4 位索引表示。例如，如果位图中的第一个字节0x1F，则字节表示两个像素。第一个像素包含第二个表条目中的颜色，第二个像素包含第十六个表条目中的颜色。
8	位图最多包含 256 种颜色， bmciColors 成员最多包含 256 个条目。在这种情况下，数组中的每个字节表示单个像素。
24	位图最多包含 2 (24) 颜色， bmciColors 成员为 NULL。位图数组中的每个三字节三元表示像素的相对强度分别为蓝色、绿色和红色。

bmciColors 表中的颜色应按重要性顺序显示。

或者，对于使用 DIB 的函数， bmciColors 成员可以是 16 位无符号整数的数组，这些整数指定当前实现的逻辑调色板中的索引，而不是显式 RGB 值。在这种情况下，使用位图的应用程序必须在将 iUsage 参数设置为 DIB_PAL_COLORS 的情况下 ( CreateDIBitmap、CreateDIBPatternBrush 和 CreateDIBSection ) 调用 DIB 函数。

注意

如果要将位图存储在文件中或传输到其他应用程序， 则 bmciColors 成员不应包含调色板索引。除非应用程序具有位图的独占使用和控制权，否则位图颜色表应包含显式 RGB 值。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	wingdi.h (包括 Windows.h)