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.

Mengembalikan nilai

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 [khusus 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