Função SetWorldTransform (wingdi.h)
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 |
Confira também
Coordenar funções de espaço e transformação