ID2D1RenderTarget ::FillOpacityMask(ID2D1Bitmap*,ID2D1Brush*,D2D1_OPACITY_MASK_CONTENT,constD2D1_RECT_F&,constD2D1_RECT_F&) méthode (d2d1.h)

Applique le masque d’opacité décrit par la bitmap spécifiée à un pinceau et utilise ce pinceau pour peindre une région de la cible de rendu.

Syntaxe

void FillOpacityMask(
  [in]  ID2D1Bitmap               *opacityMask,
  [in]  ID2D1Brush                *brush,
        D2D1_OPACITY_MASK_CONTENT content,
  [ref] const D2D1_RECT_F &       destinationRectangle,
  [ref] const D2D1_RECT_F &       sourceRectangle
);

Paramètres

[in] opacityMask

Type : ID2D1Bitmap*

Masque d’opacité à appliquer au pinceau. La valeur alpha de chaque pixel dans la région spécifiée par sourceRectangle est multipliée par la valeur alpha du pinceau une fois que le pinceau a été mappé à la zone définie par destinationRectangle.

[in] brush

Type : ID2D1Brush*

Pinceau utilisé pour peindre la région de la cible de rendu spécifiée par destinationRectangle.

content

Type : D2D1_OPACITY_MASK_CONTENT

Type de contenu que contient le masque d’opacité. La valeur est utilisée pour déterminer l’espace de couleur dans lequel le masque d’opacité est fusionné.

Note À compter de Windows 8, le D2D1_OPACITY_MASK_CONTENT n’est pas obligatoire. Consultez la méthode ID2D1DeviceContext ::FillOpacityMask , qui n’a aucun paramètre D2D1_OPACITY_MASK_CONTENT .

 

[ref] destinationRectangle

Type : const D2D1_RECT_F

Région de la cible de rendu à peindre, en pixels indépendants de l’appareil.

[ref] sourceRectangle

Type : const D2D1_RECT_F

Région de la bitmap à utiliser comme masque d’opacité, en pixels indépendants de l’appareil.

Valeur de retour

None

Remarques

Pour que cette méthode fonctionne correctement, la cible de rendu doit utiliser le mode anticrénelage D2D1_ANTIALIAS_MODE_ALIASED . Vous pouvez définir le mode anticrénelage en appelant la méthode ID2D1RenderTarget ::SetAntialiasMode .

Cette méthode ne retourne pas de code d’erreur en cas d’échec. Pour déterminer si une opération de dessin (telle que FillOpacityMask) a échoué, case activée le résultat retourné par les méthodes ID2D1RenderTarget ::EndDraw ou ID2D1RenderTarget ::Flush.

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