INTERFACE ID2D1RadialGradientBrush (d2d1.h)

Peint une zone avec un dégradé radial.

Héritage

L’interface ID2D1RadialGradientBrush hérite d’ID2D1Brush. ID2D1RadialGradientBrush a également les types de membres suivants :

• Méthodes

Méthodes

L’interface ID2D1RadialGradientBrush contient ces méthodes.

ID2D1RadialGradientBrush ::GetCenter Récupère le centre de l’ellipse de dégradé.
ID2D1RadialGradientBrush ::GetGradientOriginOffset Récupère le décalage de l’origine du dégradé par rapport au centre de l’ellipse de dégradé.
ID2D1RadialGradientBrush ::GetGradientStopCollection Récupère l’ID2D1GradientStopCollection associé à cet objet de pinceau en dégradé radial.
ID2D1RadialGradientBrush ::GetRadiusX Récupère le rayon x de l’ellipse de dégradé.
ID2D1RadialGradientBrush ::GetRadiusY Récupère le rayon y de l’ellipse de dégradé.
ID2D1RadialGradientBrush ::SetCenter Spécifie le centre de l’ellipse de dégradé dans l’espace de coordonnées du pinceau.
ID2D1RadialGradientBrush ::SetGradientOriginOffset Spécifie le décalage de l’origine du dégradé par rapport au centre de l’ellipse de dégradé.
ID2D1RadialGradientBrush ::SetRadiusX Spécifie le rayon x de l’ellipse de dégradé, dans l’espace de coordonnées du pinceau.
ID2D1RadialGradientBrush ::SetRadiusY Spécifie le rayon y de l’ellipse de dégradé, dans l’espace de coordonnées du pinceau.

Remarques

L’ID2D1RadialGradientBrush est similaire à l’ID2D1LinearGradientBrush en ce qu’ils mappent tous deux une collection d’arrêts de dégradé à un dégradé. Toutefois, le dégradé linéaire a un début et un point de fin pour définir le vecteur de dégradé, tandis que le dégradé radial utilise une ellipse et une origine de dégradé pour définir son comportement de dégradé. Pour définir la position et la taille de l’ellipse, utilisez les méthodes SetCenter, SetRadiusX et SetRadiusY pour spécifier le centre, le rayon x et le rayon y de l’ellipse. L’origine du dégradé est le centre de l’ellipse, sauf si un décalage de dégradé est spécifié à l’aide de la méthode SetGradientOriginOffset .

Le pinceau mappe la position d’arrêt de dégradé 0.0f de l’origine du dégradé, et la position 1.0f est mappée à la limite des points de suspension. Lorsque l’origine du dégradé se trouve dans l’ellipse, le contenu de l’ellipse entoure toute la plage [0, 1] des arrêts de dégradé de pinceau. Si l’origine du dégradé est en dehors des limites de l’ellipse, le pinceau fonctionne toujours, mais son dégradé n’est pas bien défini.

Le point de début et le point de fin sont décrits dans l’espace de pinceau et sont mappés à la cible de rendu lorsque le pinceau est utilisé. Notez que les coordonnées de début et de fin sont absolues et non relatives à la taille cible de rendu. Une valeur de (0, 0) correspond au coin supérieur gauche de la cible de rendu, tandis qu’une valeur de (1, 1) ne correspond qu’à un pixel en diagonale de (0, 0). S’il existe une transformation de pinceau sans identité ou une transformation cible de rendu, l’ellipse de pinceau et l’origine du dégradé sont également transformées.

Il est possible de spécifier une ellipse qui ne remplit pas complètement la zone en cours de peinture. Dans ce cas, le D2D1_EXTEND_MODE et le paramètre (spécifiés par le pinceau ID2D1GradientStopCollection) déterminent la façon dont la zone restante est peinte.

Création d’objets ID2D1RadialGradientBrush

Pour créer un pinceau de dégradé radial, utilisez la méthode ID2D1RenderTarget ::CreateRadialGradientBrush de la cible de rendu sur laquelle le pinceau sera utilisé. Le pinceau ne peut être utilisé qu’avec la cible de rendu qui l’a créé ou avec les cibles compatibles pour cette cible de rendu.

Un pinceau de dégradé radial est une ressource dépendante de l’appareil : votre application doit créer des pinceaux de dégradé radial après avoir initialisé la cible de rendu avec laquelle les pinceaux seront utilisés, et recréer les pinceaux chaque fois que la cible de rendu doit être recréée. (Pour plus d’informations sur les ressources, consultez Vue d’ensemble des ressources.)

Exemples

Pour obtenir un exemple sur la création d’un pinceau de dégradé radial, consultez la rubrique Comment créer un pinceau de dégradé radial .

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 Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d2d1.h

Voir aussi

Vue d’ensemble des pinceaux

Comment créer un pinceau de dégradé radial

ID2D1Brush