Метод IWICBitmapFrameEncode::SetColorContexts (wincodec.h)

  • Статья

Задает заданное число профилей IWICColorContext для фрейма.

Синтаксис

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

Параметры

[in] cCount

Тип: UINT

Количество устанавливаемых профилей IWICColorContext .

[in] ppIColorContext

Тип: IWICColorContext**

Указатель на указатель IWICColorContext , содержащий профили контекстов цвета, которые необходимо задать для кадра.

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

Тип: HRESULT

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

Комментарии

  • BMPНастройка контекстов цвета не поддерживается. Эта функция возвращает WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • PNGНастройка не более одного контекста цвета поддерживается, и дополнительные контексты цвета будут игнорироваться. Этот контекст должен быть wicColorContextProfile и используется для кодирования блоков iCCP, gAMA и cHRM в PNG-файле.
  • JPEG, TIFF, JPEG-XRПоддерживается настройка одного WICColorContextProfile и одного WICColorContextExifColorSpace . Пользователи не должны предоставлять более одного контекста цвета каждого типа, так как все контексты каждого типа, кроме последнего, будут игнорироваться. В JPEG WICColorContextProfile кодируется в блок метаданных JPEG APP2 ICC.

    В TIFF и JPEG-XR WICColorContextProfile кодируется в блок метаданных профиля IFD ICC (тег IFD 0x8773). Во всех трех форматах WICColorContextExifColorSpace кодируется в блок метаданных пространства цвета EXIF (тег EXIF 0xA001).

Требования

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