Метод ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES*,ID2D1Bitmap**) (d2d1.h)
Создает ID2D1Bitmap путем копирования указанного растрового изображения компонента образов Microsoft Windows (WIC).
Синтаксис
HRESULT CreateBitmapFromWicBitmap(
IWICBitmapSource *wicBitmapSource,
const D2D1_BITMAP_PROPERTIES *bitmapProperties,
[out] ID2D1Bitmap **bitmap
);
Параметры
wicBitmapSource
Тип: [in] IWICBitmapSource*
Точечный рисунок WIC для копирования.
bitmapProperties
Тип: [in, необязательный] const D2D1_BITMAP_PROPERTIES*
Формат пикселей и разрешение создаваемого растрового изображения. Формат пикселей должен соответствовать формату пикселей wicBitmapSource, в противном случае метод завершится ошибкой. Чтобы предотвратить несоответствие, можно передать значение NULL или значение, полученное при вызове вспомогательной функции D2D1::P ixelFormat , не указывая значения параметров. Если значения dpiX и dpiY имеют значение 0,0f, используется значение по умолчанию 96. Сведения о DPI, внедренные в wicBitmapSource , игнорируются.
[out] bitmap
Тип: ID2D1Bitmap**
При возврате этого метода содержит адрес указателя на новое растровое изображение. Этот параметр передается неинициализированным.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Прежде чем Direct2D сможет загрузить точечный рисунок WIC, его необходимо преобразовать в поддерживаемый формат пикселей и альфа-режим. Список поддерживаемых форматов пикселей и альфа-режимов см. в разделе Поддерживаемые форматы пикселей и альфа-режимы.
Примеры
Примеры см. в разделах How to Load a Bitmap from a File и How to Load a Bitmap from a Resource.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d2d1.h |
| Библиотека | D2d1.lib |
| DLL | D2d1.dll |