Função SetWorldTransform (wingdi.h)

Artigo
08/27/2023

A função SetWorldTransform define uma transformação linear bidimensional entre o espaço mundial e o espaço de página para o contexto do dispositivo especificado. Essa transformação pode ser usada para dimensionar, girar, distorcer ou traduzir a saída de elementos gráficos.

Sintaxe

BOOL SetWorldTransform(
  [in] HDC         hdc,
  [in] const XFORM *lpxf
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] lpxf

Um ponteiro para uma estrutura XFORM que contém os dados de transformação.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Abaixo está a matriz de transformação (observe que os dígitos na notação de elemento são um número de coluna baseado em seguida pelo número de linha baseado em 1, em vez do inverso).

| eM11 eM21 eDx |
| eM12 eM22 eDy |
| 0    0    1   |

Portanto, para quaisquer coordenadas (x, y) no espaço mundial, as coordenadas transformadas no espaço de página (x', y') podem ser determinadas da maneira mostrada abaixo.

| x' |   | eM11 eM21 eDx |   | x |   
| y' | = | eM12 eM22 eDy | . | y |
| 1  |   | 0    0    1   |   | 1 |

x' = x * eM11 + y * eM21 + eDx
y' = x * eM12 + y * eM22 + eDy

Essa função usa unidades lógicas.

A transformação do mundo geralmente é usada para dimensionar ou girar imagens lógicas de maneira independente do dispositivo.

A transformação de mundo padrão é a matriz de identidade com deslocamento zero.

A função SetWorldTransform falhará, a menos que o modo gráfico para o contexto de dispositivo fornecido tenha sido definido como GM_ADVANCED chamando anteriormente a função SetGraphicsMode . Da mesma forma, não será possível redefinir o modo gráfico do contexto do dispositivo para o modo de GM_COMPATIBLE padrão, a menos que a transformação mundial tenha sido redefinida pela primeira vez para a transformação de identidade padrão chamando SetWorldTransform ou ModifyWorldTransform.

Exemplos

Para obter um exemplo, consulte Usando espaços de coordenadas e transformações.

Requisitos


Cliente mínimo com suporte	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	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll