Метод IWICDevelopRaw::SetWhitePointKelvin (wincodec.h)

Задает значение Кельвина белой точки.

Синтаксис

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

Параметры

[in] WhitePointKelvin

Тип: UINT

Значение Кельвина белой точки. Допустимые значения Кельвина — от 1500 до 30 000.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Разработчики кодеков должны точно настраивать цветовую температуру в диапазоне, который изначально поддерживается необработанным изображением. Для значений за пределами собственного диапазона поддержки разработчик кодека должен предоставить наилучшее представление изображения при этой цветовой температуре.

Разработчики кодеков должны возвращать WINCODEC_ERR_VALUEOUTOFRANGE , если значение выходит за пределы заданного допустимого диапазона.

Разработчики кодеков должны обеспечить надлежащее взаимодействие с другими методами настройки белых точек, такими как SetWhitePointRGB. Например, если вызывающий объект задает белую точку через SetNamedWhitePoint , то реализации кодека может потребоваться отключить считывание соответствующей температуры Кельвина. В определенных случаях, когда разработчик кодека хочет запретить данное действие из-за предыдущих вызовов, необходимо вернуть WINCODEC_ERR_WRONGSTATE .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
Библиотека	Windowscodecs.lib
DLL	Windowscodecs.dll