DDCOLORCONTROL 结构 (ddraw.h)

DDCOLORCONTROL 结构定义与 Microsoft DirectDraw 视频端口扩展关联的颜色控件, (VPE) 对象。

语法

typedef struct _DDCOLORCONTROL {
  DWORD dwSize;
  DWORD dwFlags;
  LONG  lBrightness;
  LONG  lContrast;
  LONG  lHue;
  LONG  lSaturation;
  LONG  lSharpness;
  LONG  lGamma;
  LONG  lColorEnable;
  DWORD dwReserved1;
} *LPDDCOLORCONTROL, DDCOLORCONTROL;

成员

dwSize

指定此 DDCOLORCONTROL 结构的大小(以字节为单位)。

dwFlags

指示一组标志,这些标志指定哪些结构成员包含有效数据。 当 结构由 DdVideoPortColorControl 返回时,它还指示 VPE 对象支持的选项。 此成员可以是下表中列出的值的按位 OR。

标志 含义

DDCOLOR_BRIGHTNESS

lBrightness 成员包含有效数据。

DDCOLOR_CONTRAST

lContrast 成员包含有效数据。

DDCOLOR_COLORENABLE

lColorEnable 成员包含有效数据。

DDCOLOR_GAMMA

lGamma 成员包含有效数据。

DDCOLOR_HUE

lHue 成员包含有效数据。

DDCOLOR_SATURATION

lSaturation 成员包含有效数据。

DDCOLOR_SHARPNESS

lSharpness 成员包含有效数据。

lBrightness

指定黑级别) (亮度强度,以 IRE 单位*100 为单位。 此成员的范围为 0 到 10,000,默认值为 750 (7.5 IRE) 。

lContrast

指定较高强度和较低强度亮度值之间的相对差值(以 IRE 单位*100 为单位)。 此成员的范围为 0 到 20,000,默认值为 10,000 (100 IRE) 。 较高的对比度值会导致较深的亮度值倾向于黑色,而较浅的亮度值则倾向于白色。 较低的对比度值会导致所有亮度值都向中间亮度值移动。

lHue

指定色度组件的相位关系。 Hue 以度为单位指定,有效范围为 -180 到 180。 默认值为 0 度。

lSaturation

指定颜色强度,以 IRE 单位*100 为单位。 此成员的范围为 0 到 20,000,默认值为 10,000 (100 IRE) 。

lSharpness

指定以任意单位表示的锐度。 有效范围为 0 到 10,默认值为 5。

lGamma

控制应用于亮度值的伽玛校正量。 有效范围为 1 到 500 个伽玛单位,默认值为 1。

lColorEnable

指定指示是否使用颜色的标志。 如果此成员为零,则不使用颜色;如果为 1,则使用颜色。 默认值为 1。

dwReserved1

保留供系统使用,应忽略。

要求

要求
Header ddraw.h

另请参阅