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

Article
02/28/2024

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,
  D2D1_PIXEL_FORMAT                     desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  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.

desiredFormat

Type : [in] D2D1_PIXEL_FORMAT

Format de pixel et mode alpha souhaités de la nouvelle cible de rendu. Si le format de pixel est défini sur DXGI_FORMAT_UNKNOWN, la nouvelle cible de rendu utilise le même format de pixel que la cible de rendu d’origine. Si le mode alpha est D2D1_ALPHA_MODE_UNKNOWN, le mode alpha de la nouvelle cible de rendu est D2D1_ALPHA_MODE_PREMULTIPLIED par défaut. Pour plus d’informations sur les formats de pixels pris en charge, consultez Formats de pixels pris en charge et Modes alpha.

options

Type : [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

Valeur qui spécifie si la nouvelle cible de rendu doit être compatible avec GDI.

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.

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

Partager via