Método TextureBrush::GetTransform (gdiplusbrush.h)

Artículo
03/14/2023

El método TextureBrush::GetTransform obtiene la matriz de transformación de este pincel de textura.

Sintaxis

Status GetTransform(
  [out] Matrix *matrix
);

Parámetros

[out] matrix

Tipo: Matriz*

Puntero a un objeto Matrix que recibe la matriz de transformación.

Valor devuelto

Tipo: Estado

Si el método se ejecuta 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

Un objeto TextureBrush mantiene una matriz de transformación que puede almacenar cualquier transformación afín. Cuando se usa un pincel de textura para rellenar un área, GDI+ transforma la imagen del pincel según la matriz de transformación del pincel y, a continuación, rellena el área. La imagen transformada solo existe durante la representación; la imagen almacenada en el objeto TextureBrush no se transforma. Por ejemplo, supongamos que llama a someTextureBrush.ScaleTransform(3) y, a continuación, pinta un área con someTextureBrush. El ancho de la imagen del pincel se triplica cuando se pinta el área, pero la imagen almacenada en someTextureBrush permanece sin cambios.

Ejemplos

En el ejemplo siguiente se crea un pincel de textura y se establece la transformación del pincel. A continuación, el código obtiene la matriz de transformación del pincel y continúa inspeccionando o usando los elementos.

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.GetElements(elements);

   for(INT j = 0; j <=5; ++j)
   {
      // Inspect or use the value in elements[j].
   }
}

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	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll