estructura D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Contiene el desplazamiento de origen de degradado y el tamaño y la posición de la elipse de degradado para un ID2D1RadialGradientBrush.

Sintaxis

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

Miembros

center

Tipo: D2D1_POINT_2F

En el espacio de coordenadas del pincel, el centro de la elipse de degradado.

gradientOriginOffset

Tipo: D2D1_POINT_2F

En el espacio de coordenadas del pincel, el desplazamiento del origen del degradado en relación con el centro de la elipse del degradado.

radiusX

Tipo: FLOAT

En el espacio de coordenadas del pincel, el radio x de la elipse de degradado.

radiusY

Tipo: FLOAT

En el espacio de coordenadas del pincel, el radio y de la elipse de degradado.

Comentarios

Los distintos valores de center, gradientOriginOffset, radiusX o radiusY producen diferentes degradados. En la ilustración siguiente se muestran varios degradados radiales que tienen diferentes desplazamientos de origen de degradado, lo que crea la apariencia de la luz iluminando los círculos desde diferentes ángulos.

Para mayor comodidad, Direct2D proporciona la función D2D1::RadialGradientBrushProperties para crear nuevas estructuras de D2D1_RADIAL_GRADIENT_BRUSH .

Ejemplos

En el ejemplo siguiente se llama a CreateRadialGradientBrush para crear un ID2D1RadialGradientBrush. Usa la función auxiliar D2D1::RadialGradientBrushProperties para crear una estructura de D2D1_RADIAL_GRADIENT_BRUSH que tenga un valor central de (75, 5), un gradientOriginOffset de (0, 0) y un radiusX y radiusY de a 75 y pasa la estructura al método CreateRadialGradientBrush . Cuando el pincel de degradado se usa para rellenar un rectángulo, genera una salida como se muestra en la ilustración siguiente.

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

Para obtener más información sobre los pinceles de degradado radial, vea el tema How to Create a Radial Gradient Brush (Cómo crear un pincel de degradado radial ) y brushes Overview (Información general sobre pinceles).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado	d2d1.h

Consulte también

Información general sobre los pinceles

D2D1::RadialGradientBrushProperties

Cómo crear un pincel de degradado radial

ID2D1RadialGradientBrush