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

Метод ID2D1DeviceContext::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES1*,ID2D1Bitmap1**) (d2d1_1.h)

  • Статья

Создает точечный рисунок Direct2D путем копирования растрового изображения WIC.

Синтаксис

HRESULT CreateBitmapFromWicBitmap(
  [in]           IWICBitmapSource              *wicBitmapSource,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 *bitmapProperties,
  [out]          ID2D1Bitmap1                  **bitmap
);

Параметры

[in] wicBitmapSource

Тип: IWICBitmapSource*

Источник точечных изображений WIC для копирования.

[in, optional] bitmapProperties

Тип: const D2D1_BITMAP_PROPERTIES1*

Структура свойств растрового изображения, указывающая параметры создания растрового рисунка.

[out] bitmap

Тип: ID2D1Bitmap1**

Адрес вновь созданного растрового объекта.

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

Тип: HRESULT

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

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

Комментарии

Начиная с Windows 8.1 параметр bitmapProperties является необязательным. Если оно не указано, созданное растровое изображение наследует формат пикселей и альфа-режим от wicBitmapSource. Список поддерживаемых форматов пикселей и альфа-режимов см. в разделе Поддерживаемые форматы пикселей и альфа-режимы.

Если указан параметр bitmapProperties, значение в bitmapProperties-pixelFormat> должно быть DXGI_FORMAT_UNKNOWN или соответствовать формату пикселей WIC в wicBitmapSource.

Если для bitmapProperties-pixelFormat.alphaMode> задано значение D2D1_ALPHA_MODE_UNKNOWN, вновь созданное растровое изображение наследует альфа-режим от wicBitmapSource. Если для bitmapProperties-pixelFormat.alphaMode> задано значение D2D1_ALPHA_MODE_PREMULTIPLIED, D2D1_ALPHA_MODE_STRAIGHT или D2D1_ALPHA_MODE_IGNORE, вновь созданное растровое изображение будет использовать указанный альфа-режим.

Требования

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

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

ID2D1DeviceContext