estructura D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Contiene el punto inicial y el punto de conexión del eje de degradado para un id2D1LinearGradientBrush.

Sintaxis

typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;

Miembros

startPoint

Tipo: D2D1_POINT_2F

En el espacio de coordenadas del pincel, el punto inicial del eje de degradado.

endPoint

Tipo: D2D1_POINT_2F

En el espacio de coordenadas del pincel, el extremo del eje de degradado.

Comentarios

Utilice este método al crear nuevos objetos ID2D1LinearGradientBrush con el método CreateLinearGradientBrush . Para mayor comodidad, Direct2D proporciona la función auxiliar D2D1::LinearGradientBrushProperties para crear nuevas estructuras de D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES .

En la ilustración siguiente se muestra cómo cambia un degradado lineal a medida que cambia sus puntos inicial y final. Para el primer degradado, el punto inicial se establece en (0,0) y el punto final en (150, 50); esto crea un degradado diagonal que comienza en la esquina superior izquierda y se extiende a la esquina inferior derecha del área que se está pintando. Al establecer el punto inicial en (0, 25) y el punto final en (150, 25), se crea un degradado horizontal. Del mismo modo, al establecer el punto de inicio en (75, 0) y el punto final en (75, 50) se crea un degradado vertical. Al establecer el punto inicial en (0, 50) y el punto final en (150, 0), se crea un degradado diagonal que comienza en la esquina inferior izquierda y se extiende a la esquina superior derecha del área que se está pintando.

Ejemplos

En el ejemplo siguiente se usa el método CreateLinearGradientBrush para crear un id2D1LinearGradientBrush (m_pLinearGradientBrush). Usa el método auxiliar D2D1::LinearGradientBrushProperties para crear una estructura de D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES que contenga un punto inicial de (0, 0) y un punto final de (150, 150) y lo pasa al método CreateLinearGradientBrush .

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

Para obtener más información sobre cómo crear y usar pinceles de degradado lineal, vea el tema How to Create a Linear Gradient Brush (Cómo crear un pincel lineal) y la Información general sobre pinceles.

Requisitos

Consulte también

Información general sobre los pinceles

Cómo crear un pincel de degradado lineal