Metode IDirect3DDevice9::GetClipPlane (d3d9.h)
Mengambil koefisien bidang kliping yang ditentukan pengguna untuk perangkat.
Sintaks
HRESULT GetClipPlane(
[in] DWORD Index,
[out] float *pPlane
);
Parameter
[in] Index
Jenis: DWORD
Indeks bidang kliping tempat koefisien persamaan bidang diambil.
[out] pPlane
Jenis: float*
Arahkan ke array nilai empat elemen yang mewakili koefisien bidang kliping 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
Metode ini tidak akan mengembalikan status perangkat untuk perangkat yang dibuat menggunakan D3DCREATE_PUREDEVICE. Jika Anda ingin menggunakan metode ini, Anda harus membuat perangkat dengan salah satu nilai lain di D3DCREATE."
Koefisien yang dilaporkan 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 atau di belakang bidang kliping dipotong dari tempat kejadian.
Persamaan bidang yang digunakan oleh metode ini ada di ruang dunia dan diatur oleh panggilan sebelumnya ke metode IDirect3DDevice9::SetClipPlane .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |