MÉTHODE ID2D1RenderTarget ::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**) (d2d1.h)

  • Article

Crée une cible de rendu bitmap à utiliser pendant le dessin hors écran intermédiaire compatible avec la cible de rendu actuelle.

Syntaxe

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

Paramètres

desiredSize

Type : [in] D2D1_SIZE_F

Taille souhaitée de la nouvelle cible de rendu (en pixels indépendants de l’appareil), si elle doit être différente de la cible de rendu d’origine. Pour plus d’informations, consultez la section Remarques.

desiredPixelSize

Type : [in] D2D1_SIZE_U

Taille souhaitée de la nouvelle cible de rendu en pixels si elle doit être différente de la cible de rendu d’origine. Pour plus d'informations, consultez la section Notes.

bitmapRenderTarget

Type : [out] ID2D1BitmapRenderTarget**

Lorsque cette méthode est retournée, contient un pointeur vers un pointeur vers une nouvelle cible de rendu bitmap. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

La taille des pixels et la résolution de la nouvelle cible de rendu peuvent être modifiées en spécifiant des valeurs pour desiredSize ou desiredPixelSize.

  • Si desiredSize est spécifié mais que desiredPixelSize ne l’est pas, la taille des pixels est calculée à partir de la taille souhaitée à l’aide du ppp cible parent. Si desiredSize est mappé à une taille de pixels entiers, la PPP de la cible de rendu compatible est identique à la ppp de la cible parente. Si desiredSize est mappé à une taille fractionnaire de pixels, la taille des pixels est arrondie à l’entier le plus proche et la résolution de la cible de rendu compatible est légèrement supérieure à la ppp de la cible de rendu parente. Dans tous les cas, la coordonnée (desiredSize.width, desiredSize.height) est mappée à l’angle inférieur droit de la cible de rendu compatible.
  • Si l’objet desiredPixelSize est spécifié et que desiredSize ne l’est pas, le ppp de la nouvelle cible de rendu est identique à la cible de rendu d’origine.
  • Si desiredSize et desiredPixelSize sont spécifiés, la pppeur de la nouvelle cible de rendu est calculé pour tenir compte de la différence d’échelle.
  • Si ni desiredSize ni desiredPixelSize n’est spécifié, la nouvelle taille de cible de rendu et la nouvelle ppp correspondent à la cible de rendu d’origine.

La cible de rendu bitmap créée par cette méthode n’est pas compatible avec GDI.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1RenderTarget