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

Artículo
08/24/2023

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

Sintaxis

Status ScaleTransform(
  [in] REAL        sx,
  [in] REAL        sy,
  [in] MatrixOrder order
);

Parámetros

[in] sx

Tipo: REAL

Número real que especifica el factor de escala horizontal.

[in] sy

Tipo: REAL

Número real que especifica el factor de escala vertical.

[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 escalado está a la izquierda y MatrixOrderAppend especifica que la matriz de escalado 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 S representa un escalado. Si la matriz M es el TS del producto, la matriz M representa una transformación compuesta: primero traduzca y, a continuación, escale.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una ruta triangular. Las llamadas a los métodos PathGradientBrush::TranslateTransform y PathGradientBrush::ScaleTransform del objeto PathGradientBrush establecen los elementos de la matriz de transformación del pincel para que represente una transformación compuesta: primero traduzca y, a continuación, escale. 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_ScaleTransform(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.TranslateTransform(50.0f, 40.0f);               // translate
   pthGrBrush.ScaleTransform(3.0f, 2.0f, MatrixOrderAppend);  // then scale

   // 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