Fungsi SetWorldTransform (wingdi.h)
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 |
Lihat juga
Fungsi Ruang Koordinat dan Transformasi