ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,D2D1_PIXEL_FORMAT,ID2D1BitmapRenderTarget**)-Methode (d2d1.h)

  • Artikel

Erstellt ein Bitmaprenderziel für die Verwendung während einer Zwischenzeichnung, die mit dem aktuellen Renderziel kompatibel ist.

Syntax

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  D2D1_PIXEL_FORMAT       desiredFormat,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parameter

desiredSize

Typ: [in] D2D1_SIZE_F

Die gewünschte Größe des neuen Renderziels (in geräteunabhängigen Pixeln), wenn es sich vom ursprünglichen Renderziel unterscheiden sollte. Weitere Informationen finden Sie im Abschnitt Hinweise.

desiredPixelSize

Typ: [in] D2D1_SIZE_U

Die gewünschte Größe des neuen Renderziels in Pixel, wenn es sich vom ursprünglichen Renderziel unterscheiden sollte. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

desiredFormat

Typ: [in] D2D1_PIXEL_FORMAT

Das gewünschte Pixelformat und den Alphamodus des neuen Renderziels. Wenn das Pixelformat auf DXGI_FORMAT_UNKNOWN festgelegt ist, verwendet das neue Renderziel das gleiche Pixelformat wie das ursprüngliche Renderziel. Wenn der Alphamodus D2D1_ALPHA_MODE_UNKNOWN ist, wird der Alphamodus des neuen Renderziels standardmäßig auf D2D1_ALPHA_MODE_PREMULTIPLIED. Informationen zu unterstützten Pixelformaten finden Sie unter Unterstützte Pixelformate und Alphamodi.

bitmapRenderTarget

Typ: [out] ID2D1BitmapRenderTarget**

Wenn diese Methode zurückgibt, enthält einen Zeiger auf einen Zeiger auf ein neues Bitmaprenderingziel. 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

Die Pixelgröße und dpi des neuen Renderziels können durch Angeben von Werten für desiredSize oder desiredPixelSize geändert werden.

  • Wenn desiredSize angegeben ist, aber desiredPixelSize nicht, wird die Pixelgröße aus der gewünschten Größe mithilfe des übergeordneten ZIEL-DPI berechnet. Wenn die desiredSize einer ganzzahligen Pixelgröße zugeordnet ist, ist der DPI des kompatiblen Renderziels mit dem DPI des übergeordneten Ziels identisch. Bei Bedarf Wird die Größe einer Bruchpixelgröße zugeordnet, wird die Pixelgröße auf die nächste ganze Zahl aufgerundet, und der DPI für das kompatible Renderziel ist etwas höher als der DPI des übergeordneten Renderziels. In allen Fällen wird die Koordinate (desiredSize.width, desiredSize.height) der unteren rechten Ecke des kompatiblen Renderziels zugeordnet.
  • Wenn desiredPixelSize angegeben ist und desiredSize nicht, ist der DPI des neuen Renderziels identisch mit dem ursprünglichen Renderziel.
  • Wenn sowohl desiredSize als auch desiredPixelSize angegeben werden, wird der DPI des neuen Renderziels berechnet, um den Unterschied in der Skalierung zu berücksichtigen.
  • Wenn weder desiredSize noch desiredPixelSize angegeben ist, entsprechen die neue Renderzielgröße und dpi dem ursprünglichen Renderziel.

Das von dieser Methode erstellte Bitmaprenderziel ist nicht mit GDI kompatibel.

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

ID2D1RenderTarget