Метод ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**) (d2d1_3.h)

Статья
08/22/2023

Создает объект источника изображения из источника точечного изображения WIC, заполняя при этом всю пиксельную память в источнике изображения.
Образ загружается и сохраняется при использовании минимального объема памяти.

Синтаксис

HRESULT CreateImageSourceFromWic(
  [in]  IWICBitmapSource                  *wicBitmapSource,
        D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
        D2D1_ALPHA_MODE                   alphaMode,
  [out] ID2D1ImageSourceFromWic           **imageSource
);

Параметры

[in] wicBitmapSource

Тип: IWICBitmapSource*

Источник точечного изображения WIC для создания источника изображения.

loadingOptions

Тип: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Параметры для создания источника образа. Параметры по умолчанию используются, если значение NULL.

alphaMode

Тип: D2D1_ALPHA_MODE

Альфа-режим изображения; значение определяется автоматически из исходного формата пикселей, если передается D2D1_ALPHA_MODE_UNKNOWN.

[out] imageSource

Тип: ID2D1ImageSourceFromWic**

Получает новый экземпляр источника образа.

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

Тип: HRESULT

S_OK в случае успеха, в противном случае — сбой HRESULT.

Этот API поддерживает тот же набор форматов пикселей и альфа-режимов, которые поддерживаются CreateBitmapFromWicBitmap.
Если GPU не поддерживает заданный формат пикселей, этот метод возвращает D2DERR_UNSUPPORTED_PIXEL_FORMAT. Этот метод не применяет такие корректировки, как гамма- или альфа-премультипликация, влияющие на внешний вид изображения.

Параметру alphaMode не должно быть присвоено значение D2D1_ALPHA_MODE_STRAIGHT. Этот метод завершается ошибкой, если источник WIC использует формат пикселей с прямой альфа-функцией, если только альфа-режим не переопределен, задав параметру alphaMode значение D2D1_ALPHA_MODE_PREMULTIPLIED или D2D1_ALPHA_MODE_IGNORE.

Если формат источника имеет альфа-канал, необходимо передать D2D1_ALPHA_MODE_IGNORE.
Если передается D2D1_ALPHA_MODE_IGNORE и формат источника имеет альфа-канал, альфа-канал будет игнорироваться.

Этот метод автоматически выбирает подходящий формат хранения, чтобы свести к минимуму использование памяти GPU, например использование отдельных текстур яркости и хрома для изображений JPEG.

Если аргумент loadingOptions имеет значение NULL, D2D использует D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2016 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1_3.h
DLL	D2d1.dll

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

ID2D1DeviceContext2

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