Метод ID2D1RenderTarget::CreateBitmapFromWicBitmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES&,ID2D1Bitmap**) (d2d1.h)

Статья
01/10/2024

Создает id2D1Bitmap путем копирования указанного растрового изображения компонента образов Microsoft Windows (WIC).

Синтаксис

HRESULT CreateBitmapFromWicBitmap(
  IWICBitmapSource               *wicBitmapSource,
  const D2D1_BITMAP_PROPERTIES & bitmapProperties,
  ID2D1Bitmap                    **bitmap
);

Параметры

wicBitmapSource

Тип: [in] IWICBitmapSource*

Точечный рисунок WIC для копирования.

bitmapProperties

Тип: [in] const D2D1_BITMAP_PROPERTIES &

Формат пикселей и DPI создаваемого растрового изображения. Формат пикселей должен соответствовать формату пикселей wicBitmapSource, в противном случае метод завершится ошибкой. Чтобы предотвратить несоответствие, можно передать значение NULL или передать значение, полученное при вызове вспомогательной функции D2D1::P ixelFormat , не указывая значения параметров. Если и dpiX , и dpiY имеют значение 0,0f, используется значение по умолчанию 96. Сведения о DPI, внедренные в wicBitmapSource , игнорируются.

bitmap

Тип: [out] ID2D1Bitmap**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Прежде чем Direct2D сможет загрузить точечный рисунок WIC, его необходимо преобразовать в поддерживаемый формат пикселей и альфа-режим. Список поддерживаемых форматов пикселей и альфа-режимов см. в разделах Поддерживаемые форматы пикселей и Альфа-режимы.

Примеры

Примеры см. в разделах Загрузка растрового изображения из файла и Загрузка растрового изображения из ресурса.

Требования


Минимальная версия клиента	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