Metode IDirect3DDevice9::GetClipPlane (d3d9helper.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*

Penunjuk 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 adalah 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 Anda 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 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

Target Platform	Windows
Header	d3d9helper.h (termasuk D3D9.h)
Pustaka	D3D9.lib

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane