SetWorldTransform-Funktion (wingdi.h)
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 |
Weitere Informationen
Koordinatenraum und Transformationsfunktionen