Поделиться через


Структура 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. Этот элемент может быть побитовой ИЛИ значений, перечисленных в следующей таблице.

Flag Значение

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

Зарезервировано для использования системой и должно игнорироваться.

Требования

Требование Значение
Заголовок ddraw.h

См. также раздел