Método PathGradientBrush::RotateTransform (gdipluspath.h)

Artículo
08/24/2023

El método PathGradientBrush::RotateTransform actualiza la matriz de transformación actual de este pincel con el producto de sí mismo y una matriz de rotación.

Sintaxis

Status RotateTransform(
  [in] REAL        angle,
  [in] MatrixOrder order
);

Parámetros

[in] angle

Tipo: REAL

Número real que especifica el ángulo de rotación en grados.

[in] order

Tipo: MatrixOrder

Opcional. Elemento de la enumeración MatrixOrder que especifica el orden de la multiplicación. MatrixOrderPrepend especifica que la matriz de rotación está a la izquierda y MatrixOrderAppend especifica que la matriz de rotación está a la derecha. El valor predeterminado es MatrixOrderPrepend.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Una sola matriz de 3 ×3 puede almacenar cualquier secuencia de transformaciones afín. Si tiene varias matrices de 3 ×3, cada una de las cuales representa una transformación afín, el producto de esas matrices es una sola matriz de 3 ×3 que representa toda la secuencia de transformaciones. La transformación representada por ese producto se denomina transformación compuesta. Por ejemplo, supongamos que la matriz T representa una traducción y una matriz R representa una rotación. Si la matriz M es el TR del producto, la matriz M representa una transformación compuesta: primero traduzca y, a continuación, gire.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una ruta triangular. Las llamadas a los métodos PathGradientBrush::ScaleTransform y PathGradientBrush::RotateTransform del objeto PathGradientBrush establecen los elementos de la matriz de transformación del pincel para que represente una transformación compuesta: primera escala y, a continuación, gira. El código usa el pincel degradado de ruta dos veces para pintar un rectángulo: una vez antes de establecer la transformación y una vez después de establecer la transformación.

VOID Example_RotateTransform(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path gradient brush based on an array of points.
   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);

   pthGrBrush.ScaleTransform(3.0f, 1.0f);                 // first scale
   pthGrBrush.RotateTransform(60.0f, MatrixOrderAppend);  // then rotate

   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);
}

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll