ID2D1Transform ::MapInputRectsToOutputRect, méthode (d2d1effectauthor.h)

Article
02/28/2024

Effectue le mappage inverse à MapOutputRectToInputRects.

Syntaxe

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

Paramètres

[in] inputRects

Type : const D2D1_RECT_L*

Tableau de rectangles d’entrée à mapper au rectangle de sortie. Le paramètre inputRects est toujours égal aux limites d’entrée.

[in] inputOpaqueSubRects

Type : const D2D1_RECT_L*

Tableau de rectangles d’entrée à mapper au rectangle de sortie opaque.

inputRectCount

Type : UINT32

Nombre d’entrées spécifié. L’implémentation garantit que cette valeur est égale au nombre d’entrées spécifiées sur la transformation.

outputRect

Type : D2D1_RECT_L*

Rectangle de sortie mappé au rectangle d’entrée correspondant.

outputOpaqueSubRect

Type : D2D1_RECT_L*

Rectangle de sortie mappé au rectangle d’entrée opaque correspondant.

Valeur retournée

Type : HRESULT

Si la méthode réussit, elle retourne S_OK. En cas d’échec, elle retourne un code d’erreur HRESULT .

Remarques

L’implémentation de transformation doit s’assurer que toute implémentation de nuanceur de pixels ou de rappel logiciel qu’elle fournit respecte ce calcul.

Contrairement aux fonctions MapOutputRectToInputRects et MapInvalidRect , cette méthode est explicitement appelée par le convertisseur à un emplacement déterminé dans son algorithme de rendu. L’implémentation de la transformation peut modifier son état en fonction des rectangles d’entrée et utiliser ces informations pour contrôler ses informations de rendu. Cette méthode est toujours appelée avant les méthodes MapInvalidRect et MapOutputRectToInputRects de la transformation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	d2d1effectauthor.h
Bibliothèque	D2d1.lib

Voir aussi

ID2D1EffectImpl

ID2D1Transform

Partager via