Метод ID2D1DeviceContext::CreateColorContextFromFilename (d2d1_1.h)

Статья
08/22/2023

Создает контекст цвета, загружая его из указанного имени файла. Байты профиля — это содержимое файла, указанного в параметре Имя файла.

Синтаксис

HRESULT CreateColorContextFromFilename(
        PCWSTR            filename,
  [out] ID2D1ColorContext **colorContext
);

Параметры

filename

Тип: PCWSTR

Путь к файлу с байтами профиля для инициализации контекста цвета.

[out] colorContext

Тип: ID2D1ColorContext**

При возврате этого метода содержит адрес указателя на новый контекст цвета.

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

Тип: HRESULT

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

HRESULT	Описание:
S_OK	Без ошибок.
E_OUTOFMEMORY	Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG	В метод передано недопустимое значение.

Новый контекст цвета можно использовать в D2D1_BITMAP_PROPERTIES1 для инициализации цветового контекста созданного растрового изображения. Поле модели заголовка профиля проверяется, чтобы определить, является ли этот профиль sRGB или scRGB, а цветовое пространство обновляется соответственно. В противном случае пространство является пользовательским.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1_1.h
DLL	D2d1.dll

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

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

Share via