Metode IDirect3DDevice9::SetClipPlane (d3d9helper.h)
Mengatur koefisien bidang kliping yang ditentukan pengguna untuk perangkat.
Sintaks
HRESULT SetClipPlane(
[in] DWORD Index,
[in] const float *pPlane
);
Parameter
[in] Index
Jenis: DWORD
Indeks bidang kliping yang koefisien persamaan bidangnya akan diatur.
[in] pPlane
Jenis: const float*
Penunjuk ke alamat array nilai empat elemen yang mewakili koefisien bidang kliping yang akan diatur, dalam bentuk persamaan bidang umum. Lihat Keterangan.
Mengembalikan nilai
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan adalah D3DERR_INVALIDCALL. Kesalahan ini menunjukkan bahwa nilai dalam Indeks melebihi indeks bidang kliping maksimum yang didukung oleh perangkat atau bahwa array di pPlane tidak cukup besar untuk berisi empat nilai floating-point.
Keterangan
Koefisien yang ditetapkan metode ini berbentuk persamaan sarana umum. Jika nilai dalam array di pPlane diberi label A, B, C, dan D dalam urutan yang muncul dalam array, nilai tersebut akan cocok dengan persamaan bidang umum sehingga Ax + By + Cz + Dw = 0. Titik dengan koordinat homogen (x, y, z, w) terlihat di setengah ruang bidang jika Ax + By + Cz + Dw >= 0. Titik yang ada di belakang bidang kliping dipotong dari tempat kejadian.
Ketika alur fungsi tetap digunakan, persamaan bidang diasumsikan berada di ruang dunia. Ketika alur yang dapat diprogram digunakan, persamaan bidang diasumsikan berada di ruang kliping (ruang yang sama dengan simpul output).
Metode ini tidak mengaktifkan persamaan bidang kliping yang diatur. Untuk mengaktifkan bidang kliping, atur bit yang sesuai dalam nilai DWORD yang diterapkan ke status render D3DRS_CLIPPLANEENABLE.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |