Структура COLORADJUSTMENT (wingdi.h)

Статья
03/04/2024

Структура COLORADJUSTMENT определяет значения настройки цвета, используемые функциями StretchBlt и StretchDIBits , если режим растяжения — HALFTONE. Значения настройки цвета можно задать, вызвав функцию 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)