fungsi glAlphaFunc

Fungsi glAlphaFunc memungkinkan aplikasi Anda mengatur fungsi uji alfa.

Sintaks

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

Parameter

func

Fungsi perbandingan alfa. Berikut ini adalah konstanta simbolis yang diterima dan maknanya.

Nilai	Makna
GL_NEVER	Jangan pernah lewat.
GL_LESS	Lolos jika nilai alfa masuk kurang dari nilai referensi.
GL_EQUAL	Lolos jika nilai alfa masuk sama dengan nilai referensi.
GL_LEQUAL	Lolos jika nilai alfa masuk kurang dari atau sama dengan nilai referensi.
GL_GREATER	Lolos jika nilai alfa masuk lebih besar dari nilai referensi.
GL_NOTEQUAL	Lolos jika nilai alfa masuk tidak sama dengan nilai referensi.
GL_GEQUAL	Lolos jika nilai alfa masuk lebih besar dari atau sama dengan nilai referensi.
GL_ALWAYS	Selalu lewat. Ini adalah default.

ref

Nilai referensi yang dibandingkan dengan nilai alfa masuk. Nilai ini dijepit ke rentang 0 hingga 1, di mana 0 mewakili nilai alfa terendah yang mungkin dan 1 nilai tertinggi yang mungkin. Referensi defaultnya adalah 0.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

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

Keterangan

Uji alfa membuang fragmen tergantung pada hasil perbandingan antara nilai alfa fragmen masuk dan nilai referensi konstan. Fungsi glAlphaFunc menentukan fungsi referensi dan perbandingan. Perbandingan dilakukan hanya jika pengujian alfa diaktifkan. (Untuk informasi selengkapnya tentang GL_ALPHA_TEST, lihat glEnable.)

Parameter func dan ref menentukan kondisi di mana piksel digambar. Nilai alfa masuk dibandingkan dengan ref menggunakan fungsi yang ditentukan oleh func. Jika perbandingan lolos, fragmen masuk digambar, kondisional pada tes stensil dan buffer kedalaman berikutnya. Jika perbandingan gagal, tidak ada perubahan yang dilakukan pada framebuffer di lokasi piksel tersebut.

Fungsi glAlphaFunc beroperasi pada semua penulisan piksel, termasuk yang dihasilkan dari konversi pemindaian titik, garis, poligon, dan bitmap, dan dari operasi gambar dan salin piksel. Fungsi glAlphaFunc tidak memengaruhi operasi layar yang jelas.

Pengujian alfa hanya dilakukan dalam mode RGBA.

Fungsi berikut mengambil informasi yang terkait dengan fungsi glAlphaFunc :

glGet dengan argumen GL_ALPHA_TEST_FUNC

glGet dengan argumen GL_ALPHA_TEST_REF

glIsEnabled dengan argumen GL_ALPHA_TEST

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

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc