glMateriali (Fungsi glMateriali)

Artikel
06/13/2023

FungsiglMateriali menentukan parameter material untuk model pencahayaan.

Sintaks

void WINAPI glMateriali(
   GLenum face,
   GLenum pname,
   GLint  param
);

Parameter

Wajah

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

pname

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

Nilai	Makna
GL_SHININESS	Parameter param adalah bilangan bulat tunggal yang menentukan eksponen spekular RGBA dari materi. Nilai bilangan bulat dipetakan secara langsung. Hanya nilai dalam rentang [0, 128] yang diterima. Eksponen spekular default untuk material front-facing dan back-facing adalah 0.

Param

Nilai parameter mana yang GL_SHININESS akan diatur.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

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

Keterangan

Fungsi glMateriali 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 (ketika 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 glMateriali 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. Param ketiga, 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, glMateriali dapat dipanggil antara panggilan ke glBegin dan panggilan yang sesuai untuk glEnd. Namun, jika hanya satu parameter material yang akan diubah per puncak, glColorMaterial lebih disukai daripada glMateriali.

Fungsi berikut mengambil informasi yang terkait dengan glMateriali:

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