structure D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Article
02/24/2024

Contient le décalage d’origine du dégradé ainsi que la taille et la position de l’ellipse de dégradé pour un ID2D1RadialGradientBrush.

Syntaxe

typedef struct D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F center;
  D2D1_POINT_2F gradientOriginOffset;
  FLOAT         radiusX;
  FLOAT         radiusY;
} D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES;

Membres

center

Type : D2D1_POINT_2F

Dans l’espace de coordonnées du pinceau, le centre de l’ellipse de dégradé.

gradientOriginOffset

Type : D2D1_POINT_2F

Dans l’espace de coordonnées du pinceau, décalage de l’origine du dégradé par rapport au centre de l’ellipse de dégradé.

radiusX

Type : FLOAT

Dans l’espace de coordonnées du pinceau, le rayon x de l’ellipse de dégradé.

radiusY

Type : FLOAT

Dans l’espace de coordonnées du pinceau, rayon y de l’ellipse de dégradé.

Remarques

Des valeurs différentes pour center, gradientOriginOffset, radiusX et/ou radiusY produisent des dégradés différents. L’illustration suivante montre plusieurs dégradés radials qui ont des décalages d’origine différents, créant l’apparence de la lumière éclairant les cercles sous différents angles.

Illustration de quatre cercles avec des dégradés radial qui ont des décalages d’origine différents

Pour plus de commodité, Direct2D fournit la fonction D2D1 ::RadialGradientBrushProperties pour créer de nouvelles structures D2D1_RADIAL_GRADIENT_BRUSH .

Exemples

L’exemple suivant appelle CreateRadialGradientBrush pour créer un ID2D1RadialGradientBrush. Il utilise la fonction d’assistance D2D1 ::RadialGradientBrushProperties pour créer une structure de D2D1_RADIAL_GRADIENT_BRUSH qui a une valeur centrale de (75, 5), un gradientOriginOffset de (0, 0) et un radiusX et radiusY de 75 et transmet la structure à la méthode CreateRadialGradientBrush . Lorsque le pinceau dégradé est utilisé pour remplir un rectangle, il produit une sortie comme illustré dans l’illustration suivante.

Illustration d’un cercle avec un pinceau dégradé radial

// The center of the gradient is in the center of the box.
// The gradient origin offset was set to zero(0, 0) or center in this case.
if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateRadialGradientBrush(
        D2D1::RadialGradientBrushProperties(
            D2D1::Point2F(75, 75),
            D2D1::Point2F(0, 0),
            75,
            75),
        pGradientStops,
        &m_pRadialGradientBrush
        );
}

Pour plus d’informations sur les pinceaux de dégradé radial, consultez la rubrique Création d’un pinceau de dégradé radial et vue d’ensemble des pinceaux.

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]
En-tête	d2d1.h

Voir aussi

Vue d’ensemble des pinceaux

D2D1 ::RadialGradientBrushProperties

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

ID2D1RadialGradientBrush

Partager via