SetWorldTransform-Funktion (wingdi.h)

Artikel
08/27/2023

Die SetWorldTransform-Funktion legt eine zweidimensionale lineare Transformation zwischen Welt- und Seitenraum für den angegebenen Gerätekontext fest. Diese Transformation kann zum Skalieren, Drehen, Scheren oder Übersetzen der Grafikausgabe verwendet werden.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] lpxf

Ein Zeiger auf eine XFORM-Struktur , die die Transformationsdaten enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Unten sehen Sie die Transformationsmatrix (beachten Sie, dass die Ziffern in der Elementnotation eine 1-basierte Spaltennummer sind, gefolgt von einer 1-basierten Zeilennummer anstelle der umgekehrten).

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

Für alle Koordinaten (x, y) im Weltraum können also die transformierten Koordinaten im Seitenraum (x', y') wie unten dargestellt bestimmt werden.

| 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

Diese Funktion verwendet logische Einheiten.

Die Welttransformation wird in der Regel verwendet, um logische Bilder geräteunabhängig zu skalieren oder zu rotieren.

Die Standard-Welttransformation ist die Identitätsmatrix mit null Offset.

Die SetWorldTransform-Funktion schlägt fehl, es sei denn, der Grafikmodus für den angegebenen Gerätekontext wurde auf GM_ADVANCED festgelegt, indem zuvor die SetGraphicsMode-Funktion aufgerufen wurde. Ebenso ist es nicht möglich, den Grafikmodus für den Gerätekontext auf den Standardmodus GM_COMPATIBLE zurückzusetzen, es sei denn, die Welttransformation wurde zuerst durch Aufrufen von SetWorldTransform oder ModifyWorldTransform auf die Standardidentitätstransformation zurückgesetzt.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Koordinatenräumen und Transformationen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll