Freigeben über


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

Übersicht über Koordinatenräume und Transformationen

GetWorldTransform

ModifyWorldTransform

SetGraphicsMode

SetMapMode

SetViewportExtEx

SetViewportOrgEx

SetWindowExtExtEx

SetWindowOrgEx

XFORM