ID2D1Transform::MapInputRectsToOutputRect-Methode (d2d1effectauthor.h)

Artikel
02/28/2024

Führt die umgekehrte Zuordnung zu MapOutputRectToInputRects aus.

Syntax

HRESULT MapInputRectsToOutputRect(
  [in] const D2D1_RECT_L *inputRects,
  [in] const D2D1_RECT_L *inputOpaqueSubRects,
       UINT32            inputRectCount,
       D2D1_RECT_L       *outputRect,
       D2D1_RECT_L       *outputOpaqueSubRect
);

Parameter

[in] inputRects

Typ: const D2D1_RECT_L*

Ein Array von Eingaberechtecken, die dem Ausgaberechteck zugeordnet werden sollen. Der inputRects-Parameter ist immer gleich den Eingabegrenzen.

[in] inputOpaqueSubRects

Typ: const D2D1_RECT_L*

Ein Array von Eingaberechtecken, die dem undurchsichtigen Ausgaberechteck zugeordnet werden sollen.

inputRectCount

Typ: UINT32

Die anzahl der angegebenen Eingaben. Die Implementierung garantiert, dass dies der Anzahl der Eingaben entspricht, die für die Transformation angegeben sind.

outputRect

Typ: D2D1_RECT_L*

Das Ausgaberechteck, das dem entsprechenden Eingaberechteck zugeordnet ist.

outputOpaqueSubRect

Typ: D2D1_RECT_L*

Das Ausgaberechteck, das dem entsprechenden undurchsichtigen Eingaberechteck zugeordnet ist.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Die Transformationsimplementierung muss sicherstellen, dass jede von ihr bereitgestellte Pixelshader- oder Softwarerückrufimplementierung diese Berechnung berücksichtigt.

Im Gegensatz zu den Funktionen MapOutputRectToInputRects und MapInvalidRect wird diese Methode explizit vom Renderer an einer bestimmten Stelle in seinem Renderingalgorithmus aufgerufen. Die Transformationsimplementierung kann ihren Zustand basierend auf den Eingaberechtecken ändern und diese Informationen verwenden, um die Renderinginformationen zu steuern. Diese Methode wird immer vor den Methoden MapInvalidRect und MapOutputRectToInputRects der Transformation aufgerufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1effectauthor.h
Bibliothek	D2d1.lib

Weitere Informationen

ID2D1EffectImpl

ID2D1Transform

Freigeben über