MÉTHODE ID2D1DeviceContext::D rawImage(ID2D1Image,constD2D1_POINT_2F,constD2D1_RECT_F*,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) (d2d1_1.h)

Article
08/22/2023

Dessine une image dans le contexte de l’appareil.

Syntaxe

void DrawImage(
  [in]           ID2D1Image              *image,
  [in, optional] const D2D1_POINT_2F     *targetOffset,
  [in, optional] const D2D1_RECT_F       *imageRectangle,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

Paramètres

[in] image

Type : ID2D1Image*

Image à dessiner dans le contexte de l’appareil.

[in, optional] targetOffset

Type : const D2D1_POINT_2F*

Décalage dans l’espace de destination dans lequel l’image sera rendue. L’intégralité de l’étendue logique de l’image sera rendue à la destination correspondante. Si elle n’est pas spécifiée, l’origine de destination est (0, 0). Le coin supérieur gauche de l’image est mappé au décalage cible. Ce ne sera pas nécessairement l’origine. Cette valeur par défaut est NULL.

[in, optional] imageRectangle

Type : const D2D1_RECT_F*

Le rectangle correspondant dans l’espace d’image sera mappé à l’origine donnée lors du traitement de l’image. Cette valeur par défaut est NULL.

interpolationMode

Type : D2D1_INTERPOLATION_MODE

Mode d’interpolation qui sera utilisé pour mettre à l’échelle l’image si nécessaire.

compositeMode

Type : D2D1_COMPOSITE_MODE

Mode composite qui sera appliqué aux limites du clip actuellement sélectionné. La valeur par défaut est D2D1_COMPOSITE_MODE_SOURCE_OVER

Valeur de retour

None

Remarques

Si interpolationMode est D2D1_INTERPOLATION_MODE_HIGH_QUALITY, différents scalers seront utilisés en fonction du facteur d’échelle impliqué par la transformation mondiale.

Tous les rectangles non valides accumulés sur un effet dessiné par cet appel seront ignorés, quelle que soit la partie du rectangle d’image qui est dessinée.

Si compositeMode est D2D1_COMPOSITE_MODE_SOURCE_OVER, DrawImage utilise le mélange primitif actuellement sélectionné spécifié par ID2D1DeviceContext::SetPrimitiveBlend. Si compositeMode n’est pas D2D1_COMPOSITE_MODE_SOURCE_OVER, l’image est étendue pour être transparente jusqu’au clip aligné sur l’axe actuel.

S’il existe un rectangle d’image et une transformation du monde, cela équivaut à insérer un effet clip pour représenter le rectangle d’image et une transformation affine 2D pour prendre en compte la transformation du monde.

Configuration requise


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	d2d1_1.h
DLL	D2d1.dll