D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES struttura (d2d1.h)

Contiene l'offset di origine sfumatura e la dimensione e la posizione dei puntini di sospensione sfumatura per un ID2D1RadialGradientBrush.

Sintassi

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

Members

center

Tipo: D2D1_POINT_2F

Nello spazio delle coordinate del pennello, il centro dei puntini di sospensione sfumatura.

gradientOriginOffset

Tipo: D2D1_POINT_2F

Nello spazio delle coordinate del pennello, l'offset dell'origine sfumatura rispetto al centro dell'ellisse sfumatura.

radiusX

Tipo: FLOAT

Nello spazio delle coordinate del pennello, il raggio x dell'ellisse sfumatura.

radiusY

Tipo: FLOAT

Nello spazio delle coordinate del pennello, il raggio y dell'ellisse sfumatura.

Commenti

Valori diversi per centro, gradientOriginOffset, radiusX e/o radiusY producono sfumature diverse. La figura seguente mostra diverse sfumature radiali con offset di origine sfumatura diversi, creando l'aspetto della luce che illumina i cerchi da angoli diversi.

Per praticità, Direct2D fornisce la funzione D2D1::RadialGradientBrushProperties per la creazione di nuove strutture di D2D1_RADIAL_GRADIENT_BRUSH .

Esempio

Nell'esempio seguente viene chiamato CreateRadialGradientBrush per creare un ID2D1RadialGradientBrush. Usa la funzione helper D2D1::RadialGradientBrushProperties per creare una struttura D2D1_RADIAL_GRADIENT_BRUSH con un valore centrale (75, 5), un gradientOriginOffset di (0, 0, 0) e un radiusX e radiusY di fino a 75 e passa la struttura al metodo CreateRadialGradientBrush . Quando il pennello sfumatura viene usato per riempire un rettangolo, produce l'output, come illustrato nella figura seguente.

// 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
        );
}

Per altre informazioni sui pennelli sfumature radiali, vedere l'argomento How to Create a Radial Gradient Brush (Come creare un pennello sfumatura radiale ) e la panoramica dei pennelli.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Intestazione	d2d1.h

Vedi anche

Panoramica dei pennelli

D2D1::RadialGradientBrushProperties

Come creare un pennello sfumatura radiale

ID2D1RadialGradientBrush