Compartir a través de


Interfaz ID2D1RadialGradientBrush (d2d1.h)

Pinta un área con un degradado radial.

Herencia

La interfaz ID2D1RadialGradientBrush hereda de ID2D1Brush. ID2D1RadialGradientBrush también tiene estos tipos de miembros:

Métodos

La interfaz ID2D1RadialGradientBrush tiene estos métodos.

 
ID2D1RadialGradientBrush::GetCenter

Recupera el centro de la elipse de degradado.
ID2D1RadialGradientBrush::GetGradientOriginOffset

Recupera el desplazamiento del origen del degradado en relación con el centro de la elipse del degradado.
ID2D1RadialGradientBrush::GetGradientStopCollection

Recupera la colección ID2D1GradientStopCollection asociada a este objeto de pincel de degradado radial.
ID2D1RadialGradientBrush::GetRadiusX

Recupera el radio x de la elipse de degradado.
ID2D1RadialGradientBrush::GetRadiusY

Recupera el radio y de la elipse de degradado.
ID2D1RadialGradientBrush::SetCenter

Especifica el centro de la elipse de degradado en el espacio de coordenadas del pincel.
ID2D1RadialGradientBrush::SetGradientOriginOffset

Especifica el desplazamiento del origen del degradado en relación con el centro de la elipse del degradado.
ID2D1RadialGradientBrush::SetRadiusX

Especifica el radio x de la elipse de degradado, en el espacio de coordenadas del pincel.
ID2D1RadialGradientBrush::SetRadiusY

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

Comentarios

Id2D1RadialGradientBrush es similar al ID2D1LinearGradientBrush en que asignan una colección de delimitadores de degradado a un degradado. Sin embargo, el degradado lineal tiene un inicio y un punto final para definir el vector de degradado, mientras que el degradado radial usa una elipse y un origen de degradado para definir su comportamiento de degradado. Para definir la posición y el tamaño de la elipse, use los métodos SetCenter, SetRadiusX y SetRadiusY para especificar el centro, el radio x y el radio Y de la elipse. El origen del degradado es el centro de la elipse, a menos que se especifique un desplazamiento de degradado mediante el método SetGradientOriginOffset .

El pincel asigna la posición de parada de degradado 0,0f del origen del degradado y la posición 1,0f se asigna al límite de la elipse. Cuando el origen del degradado está dentro de la elipse, el contenido de la elipse incluye todo el intervalo [0, 1] del degradado del pincel. Si el origen del degradado está fuera de los límites de la elipse, el pincel sigue funcionando, pero su degradado no está bien definido.

El punto inicial y el punto final se describen en el espacio de pincel y se asignan al destino de representación cuando se usa el pincel. Tenga en cuenta que las coordenadas inicial y final son absolutas, no relativas al tamaño de destino de representación. Un valor de (0, 0) se asigna a la esquina superior izquierda del destino de representación, mientras que un valor de (1, 1) asigna un píxel diagonalmente lejos de (0, 0). Si hay una transformación de pincel noidentidad o una transformación de destino de representación, también se transforman la elipse del pincel y el origen del degradado.

Es posible especificar una elipse que no llena completamente el área que se está pintando. Cuando esto ocurre, el D2D1_EXTEND_MODE y la configuración (especificado por el pincel ID2D1GradientStopCollection) determina cómo se pinta el área restante.

Crear objetos ID2D1RadialGradientBrush

Para crear un pincel de degradado radial, use el método ID2D1RenderTarget::CreateRadialGradientBrush del destino de representación en el que se usará el pincel. El pincel solo se puede usar con el destino de representación que lo creó o con los destinos compatibles para ese destino de representación.

Un pincel de degradado radial es un recurso dependiente del dispositivo: la aplicación debe crear pinceles de degradado radial después de inicializar el destino de representación con el que se usarán los pinceles y volver a crear los pinceles cada vez que se necesite volver a crear el destino de representación. (Para obtener más información sobre los recursos, consulte Información general sobre recursos).

Ejemplos

Para obtener un ejemplo sobre cómo crear un pincel de degradado radial, vea el tema How to Create a Radial Gradient Brush (Cómo crear un pincel de degradado radial ).

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]
Plataforma de destino Windows
Encabezado d2d1.h

Consulte también

Información general sobre los pinceles

Cómo crear un pincel de degradado radial

ID2D1Brush