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

Paramètres

desiredSize

Type : [in] const 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] const 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] const 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 par défaut D2D1_ALPHA_MODE_PREMULTIPLIED. 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 retourne, 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, il retourne un code d’erreur HRESULT .

Remarques

La taille des pixels et le DPI de la nouvelle cible de rendu peuvent être modifiés 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 le desiredSize est mappé à une taille de pixels entiers, le DPI de la cible de rendu compatible est identique à celui de la cible parente. Si desiredSize correspond à une taille fractionnaire de pixels, la taille des pixels est arrondie à l’entier le plus proche et le DPI de la cible de rendu compatible est légèrement plus élevé que le ppp de la cible de rendu parente. Dans tous les cas, la coordonnée (desiredSize.width, desiredSize.height) correspond au coin inférieur droit de la cible de rendu compatible.
  • Si la propriété desiredPixelSize est spécifiée et que desiredSize n’est pas, le DPI de la nouvelle cible de rendu est identique à la cible de rendu d’origine.
  • Si desiredSize et desiredPixelSize sont spécifiés, le DPI 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 le DPI correspondent à la cible de rendu d’origine.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1RenderTarget