fungsi glClipPlane

Fungsi glClipPlane menentukan bidang tempat semua geometri dipotong.

Sintaks

void WINAPI glClipPlane(
         GLenum   plane,
   const GLdouble *equation
);

Parameter

Pesawat

Bidang kliping yang sedang diposisikan. Nama simbolis formulir GL_CLIP_PLANEi, di mana i adalah bilangan bulat antara 0 dan GL_MAX_CLIP_PLANES - 1, diterima.

persamaan

Alamat array empat nilai floating-point presisi ganda. Nilai-nilai ini ditafsirkan sebagai persamaan bidang.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	pesawat bukan nilai yang diterima.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Geometri selalu dipotong terhadap batas frustum enam bidang dalam x, y, dan z. Fungsi glClipPlane memungkinkan spesifikasi bidang tambahan, tidak selalu tegak lurus terhadap sumbu x, sumbu y, atau sumbu z, di mana semua geometri dipotong. Hingga bidang GL_MAX_CLIP_PLANES dapat ditentukan, di mana GL_MAX_CLIP_PLANES setidaknya enam dari semua implementasi. Karena wilayah kliping yang dihasilkan adalah persimpangan dari setengah spasi yang ditentukan, wilayah tersebut selalu cembung.

Fungsi glClipPlane menentukan setengah ruang menggunakan persamaan bidang empat komponen. Ketika Anda memanggil glClipPlane, persamaan diubah oleh inversi matriks tampilan model dan disimpan dalam koordinat mata yang dihasilkan. Perubahan berikutnya pada matriks tampilan model tidak berpengaruh pada komponen persamaan bidang yang disimpan. Jika produk titik koordinat mata verteks dengan komponen persamaan bidang tersimpan positif atau nol, puncaknya berkaitan dengan bidang kliping tersebut. Jika tidak, itu adalah keluar.

Gunakan fungsi glEnable dan glDisable untuk mengaktifkan dan menonaktifkan bidang kliping. Panggil bidang kliping dengan argumen GL_CLIP_PLANEi, di mana saya adalah nomor pesawat.

Secara default, semua bidang kliping didefinisikan sebagai (0,0,0,0) dalam koordinat mata dan dinonaktifkan.

Selalu kasus yang GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

Fungsi berikut mengambil informasi yang terkait dengan glClipPlane:

glGetClipPlane

glIsEnabled dengan argumen GL_CLIP_PLANE i

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Gl.h
Pustaka	Opengl32.lib
DLL	Opengl32.dll

Lihat juga

glBegin

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled