Función SetWorldTransform (wingdi.h)

Artículo
08/27/2023

La función SetWorldTransform establece una transformación lineal bidimensional entre el espacio mundial y el espacio de página para el contexto de dispositivo especificado. Esta transformación se puede usar para escalar, rotar, distorsionar o traducir la salida de gráficos.

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] lpxf

Puntero a una estructura XFORM que contiene los datos de transformación.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

A continuación se muestra la matriz de transformación (tenga en cuenta que los dígitos de la notación de elementos son un número de columna basado en 1 seguido de un número de fila basado en 1, en lugar del inverso).

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

Por lo tanto, para cualquier coordenada (x, y) en el espacio del mundo, las coordenadas transformadas en el espacio de página (x', y') se pueden determinar de la manera que se muestra a continuación.

| 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

Esta función usa unidades lógicas.

Normalmente, la transformación del mundo se usa para escalar o girar imágenes lógicas de forma independiente del dispositivo.

La transformación del mundo predeterminada es la matriz de identidades con desplazamiento cero.

La función SetWorldTransform producirá un error a menos que el modo gráfico del contexto de dispositivo determinado se haya establecido en GM_ADVANCED llamando previamente a la función SetGraphicsMode . Del mismo modo, no será posible restablecer el modo de gráficos para el contexto del dispositivo al modo de GM_COMPATIBLE predeterminado, a menos que la transformación del mundo se haya restablecido primero a la transformación de identidad predeterminada llamando a SetWorldTransform o ModifyWorldTransform.

Ejemplos

Para obtener un ejemplo, consulte Uso de espacios de coordenadas y transformaciones.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll