Metode IDirect3DDevice9::SetClipPlane (d3d9helper.h)

Artikel
03/04/2024

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

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::GetClipPlane

Share via