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

Artigo
08/24/2023

O método TextureBrush::ScaleTransform atualiza a matriz de transformação atual desse pincel de textura com o produto de si mesmo e uma matriz de dimensionamento.

Sintaxe

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

Parâmetros

[in] sx

Tipo: REAL

Número real que especifica a quantidade a ser dimensionada na direção x.

[in] sy

Tipo: REAL

Número real que especifica a quantidade a ser dimensionada na direção y.

[in] order

Tipo: MatrixOrder

Opcional. Elemento da enumeração MatrixOrder que especifica a ordem da multiplicação. MatrixOrderPrepend especifica que a matriz de dimensionamento está à esquerda e MatrixOrderAppend especifica que a matriz de dimensionamento está à direita. O valor padrão é MatrixOrderPrepend.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Uma única matriz 3×3 pode armazenar qualquer sequência de transformações de afins. Se você tiver várias matrizes 3×3, cada uma representando uma transformação de afinação, o produto dessas matrizes será uma única matriz de 3×3 que representa toda a sequência de transformações. A transformação representada por esse produto é chamada de transformação composta. Por exemplo, suponha que a matriz T represente uma tradução e a matriz S represente um dimensionamento. Se matrix M for o TS do produto, a matriz M representará uma transformação composta: primeiro traduzir e, em seguida, dimensionar.

A ordem de multiplicação de matriz é importante. Em geral, o RT do produto de matriz não é o mesmo que o TR do produto de matriz. No exemplo dado no parágrafo anterior, a transformação composta representada por RT (primeiro girar, depois traduzir) não é a mesma que a transformação composta representada por TR (primeiro traduzir, depois girar).

Exemplos

O exemplo a seguir cria um pincel de textura e define a transformação do pincel. Em seguida, o código usa o pincel transformado para preencher um retângulo.

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

   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.RotateTransform(30);                      // first rotate
   textureBrush.ScaleTransform(3, 1, MatrixOrderAppend);  // then scale
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusbrush.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll