ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,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(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

Parameter

desiredSize

Typ: [in] const 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] const 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] const 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.

options

Typ: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

Ein Wert, der angibt, ob das neue Renderziel mit GDI kompatibel sein muss.

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 geändert werden, indem Sie Werte für desiredSize oder desiredPixelSize angeben:

  • 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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1RenderTarget