ID2D1RenderTarget::CreateBitmapFromWicBitmapmap(IWICBitmapSource*,constD2D1_BITMAP_PROPERTIES*,ID2D1Bitmap**)-Methode (d2d1.h)

  • Artikel

Erstellt eine ID2D1Bitmap durch Kopieren der angegebenen WiC-Bitmap (Microsoft Windows Imaging Component).

Syntax

HRESULT CreateBitmapFromWicBitmap(
        IWICBitmapSource             *wicBitmapSource,
        const D2D1_BITMAP_PROPERTIES *bitmapProperties,
  [out] ID2D1Bitmap                  **bitmap
);

Parameter

wicBitmapSource

Typ: [in] IWICBitmapSource*

Die zu kopierende WIC-Bitmap.

bitmapProperties

Typ: [in, optional] const D2D1_BITMAP_PROPERTIES*

Das Pixelformat und dpi der zu erstellenden Bitmap. Das Pixelformat muss mit dem Pixelformat von wicBitmapSource übereinstimmen, andernfalls schlägt die Methode fehl. Um einen Konflikt zu verhindern, können Sie NULL übergeben oder den Wert übergeben, der durch das Aufrufen der Hilfsfunktion D2D1::P ixelFormat abgerufen wurde, ohne Parameterwerte anzugeben. Wenn sowohl dpiX als auch dpiY 0.0f sind, wird der Standard-DPI 96 verwendet. DPI-Informationen, die in wicBitmapSource eingebettet sind, werden ignoriert.

[out] bitmap

Typ: ID2D1Bitmap**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die neue Bitmap. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Bevor Direct2D eine WIC-Bitmap laden kann, muss diese Bitmap in ein unterstütztes Pixelformat und den Alphamodus konvertiert werden. Eine Liste der unterstützten Pixelformate und Alphamodi finden Sie unter Unterstützte Pixelformate und Alphamodi.

Beispiele

Beispiele finden Sie unter Laden einer Bitmap aus einer Datei und Laden einer Bitmap aus einer Ressource.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

So laden Sie eine Bitmap aus einer Datei

ID2D1Bitmap

ID2D1RenderTarget

Unterstützte Pixelformate und Alpha-Modi