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

Метод 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

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

Загрузка растрового изображения из файла

ID2D1Bitmap

ID2D1RenderTarget

Поддерживаемые форматы пикселей и режимы альфа-канала