Fungsi SetWorldTransform (wingdi.h)

Artikel
03/08/2023

Fungsi SetWorldTransform menetapkan transformasi linier dua dimensi antara ruang dunia dan ruang halaman untuk konteks perangkat yang ditentukan. Transformasi ini dapat digunakan untuk menskalakan, memutar, menikung, atau menerjemahkan output grafis.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpxf

Penunjuk ke struktur XFORM yang berisi data transformasi.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Di bawah ini adalah matriks transformasi (perhatikan bahwa digit dalam notasi elemen adalah nomor kolom berbasis 1 diikuti oleh nomor baris berbasis 1, bukan sebaliknya).

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

Jadi untuk koordinat apa pun (x, y) di ruang dunia, koordinat yang diubah di ruang halaman (x', y') dapat ditentukan dengan cara yang ditunjukkan di bawah ini.

| 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

Fungsi ini menggunakan unit logis.

Transformasi dunia biasanya digunakan untuk menskalakan atau memutar gambar logis dengan cara yang tidak bergantung pada perangkat.

Transformasi dunia default adalah matriks identitas dengan offset nol.

Fungsi SetWorldTransform akan gagal kecuali mode grafis untuk konteks perangkat tertentu telah diatur ke GM_ADVANCED dengan sebelumnya memanggil fungsi SetGraphicsMode . Demikian juga, tidak akan mungkin untuk mengatur ulang mode grafis untuk konteks perangkat ke mode GM_COMPATIBLE default, kecuali transformasi dunia pertama kali telah diatur ulang ke transformasi identitas default dengan memanggil SetWorldTransform atau ModifyWorldTransform.

Contoh

Misalnya, lihat Menggunakan Ruang Koordinat dan Transformasi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll