fungsi glMaterialf

Artikel
06/13/2023

Fungsi glMaterialf menentukan parameter material untuk model pencahayaan.

Sintaks

void WINAPI glMaterialf(
   GLenum  face,
   GLenum  pname,
   GLfloat param
);

Parameter

Wajah

Wajah atau wajah yang sedang diperbarui. Harus salah satu hal berikut: GL_FRONT, GL_BACK, atau GL_FRONT dan GL_BACK.

nama p

Parameter material bernilai tunggal dari wajah atau wajah yang diperbarui. Pasti GL_SHININESS.

Nilai	Makna
GL_SHININESS	Parameter param adalah nilai floating-point tunggal yang menentukan eksponen spekular RGBA dari bahan. Nilai bilangan bulat dipetakan secara langsung. Hanya nilai dalam rentang [0, 128] yang diterima. Eksponen spekular default untuk bahan yang menghadap ke depan dan belakang adalah 0.

Param

Nilai yang GL_SHININESS parameter akan ditetapkan.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	Wajah ataupname bukan nilai yang diterima.
GL_INVALID_VALUE	Eksponen spekular di luar kisaran [0, 128] ditentukan.

Keterangan

Fungsi glMaterialf menetapkan nilai ke parameter material. Ada dua set parameter material yang cocok. Satu, set menghadap depan , digunakan untuk menaungi titik, garis, bitmap, dan semua poligon (ketika pencahayaan dua sisi dinonaktifkan), atau hanya poligon menghadap depan (saat pencahayaan dua sisi diaktifkan). Set lainnya, menghadap ke belakang, digunakan untuk menaungi poligon yang menghadap ke belakang hanya ketika pencahayaan dua sisi diaktifkan. Lihat glLightModel untuk detail tentang perhitungan pencahayaan satu sisi dan dua sisi.

Fungsi glMaterialf mengambil tiga argumen. Yang pertama, wajah, menentukan apakah bahan GL_FRONT, bahan GL_BACK, atau kedua bahan GL_FRONT_AND_BACK akan dimodifikasi. Yang kedua, pname, menentukan parameter mana dalam satu atau kedua set yang akan dimodifikasi. Yang ketiga, param, menentukan nilai apa yang akan ditetapkan ke parameter yang ditentukan.

Parameter material digunakan dalam persamaan pencahayaan yang secara opsional diterapkan ke setiap puncak. Persamaan dibahas dalam glLightModel.

Parameter material dapat diperbarui kapan saja. Secara khusus, glMaterialf dapat dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. Namun, jika hanya satu parameter material yang akan diubah per vertex, glColorMaterial lebih disukai daripada glMaterialf.

Fungsi berikut mengambil informasi yang terkait dengan glMaterialf:

glGetMaterial

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

glColorMaterial
glLight
glLightModel

Bagikan melalui