Метод 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. Возможные значения включают, но не ограничиваются ими в следующей таблице.

Замечания

Начиная с 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, это заставляет только что созданную растровую карту использовать указанный альфа-режим.

Требования

См. также

ID2D1DeviceContext