COLORADJUSTMENT 结构 (wingdi.h)

项目
03/04/2024

当拉伸模式为 HALFTONE 时， COLORADJUSTMENT 结构定义 StretchBlt 和 StretchDIBits 函数使用的颜色调整值。可以通过调用 SetColorAdjustment 函数来设置颜色调整值。

语法

typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT, *LPCOLORADJUSTMENT;

成员

caSize

结构的大小（以字节为单位）。

caFlags

指定应如何准备输出图像。此成员可以设置为 NULL 或以下值的任意组合。

值	含义
CA_NEGATIVE	指定应显示原始图像的底片。
CA_LOG_FILTER	指定应将对数函数应用于输出颜色的最终密度。当亮度较低时，这将增加颜色对比度。

caIlluminantIndex

用于查看图像的标准光源的类型。此成员可以设置为以下值之一。

值	含义
ILLUMINANT_DEVICE_DEFAULT	设备的默认值。输出设备使用的标准。
ILLUMINANT_A	灯泡。
ILLUMINANT_B	中午的阳光。
ILLUMINANT_C	NTSC 日光。
ILLUMINANT_D50	正常打印。
ILLUMINANT_D55	绑定纸张打印。
ILLUMINANT_D65	标准日光。 CRT 和图片的标准。
ILLUMINANT_D75	北日照。
ILLUMINANT_F2	凉爽的白色灯。
ILLUMINANT_TUNGSTEN	与 ILLUMINANT_A 相同。
ILLUMINANT_DAYLIGHT	与 ILLUMINANT_C 相同。
ILLUMINANT_FLUORESCENT	与 ILLUMINANT_F2 相同。
ILLUMINANT_NTSC	与 ILLUMINANT_C 相同。

caRedGamma

指定源颜色的红色原色的第 n^个幂伽玛校正值。该值必须介于 2500 到 65,000 的范围内。值为 10,000 表示没有伽玛校正。

caGreenGamma

指定源颜色的绿色原色的第 n^个幂伽玛校正值。该值必须介于 2500 到 65,000 的范围内。值为 10,000 表示没有伽玛校正。

caBlueGamma

指定源颜色的蓝色原色的第 n^个幂伽玛校正值。该值必须介于 2500 到 65,000 的范围内。值为 10,000 表示没有伽玛校正。

caReferenceBlack

源颜色的黑色参考。任何比此深的颜色都被视为黑色。该值必须介于 0 到 4000 的范围内。

caReferenceWhite

源颜色的白色参考。任何比此更浅的颜色都被视为白色。该值必须介于 6000 到 10,000 的范围内。

caContrast

要应用于源对象的对比度。该值必须介于 -100 到 100 的范围内。值为 0 表示没有对比度调整。

caBrightness

要应用于源对象的亮度。该值必须介于 -100 到 100 的范围内。值为 0 表示不调整亮度。

caColorfulness

要应用于源对象的色彩量。该值必须介于 -100 到 100 的范围内。值为 0 表示没有色彩调整。

caRedGreenTint

要应用于源对象的红色或绿色色调调整量。该值必须介于 -100 到 100 的范围内。正数调整为红色，负数调整为绿色。零表示没有色调调整。

要求

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