fungsi glLighti

Fungsi glLighti mengembalikan nilai parameter sumber cahaya.

Sintaks

void WINAPI glLighti(
   GLenum light,
   GLenum pname,
   GLint  param
);

Parameter

Cahaya

Pengidentifikasi cahaya. Jumlah kemungkinan lampu tergantung pada implementasinya, tetapi setidaknya delapan lampu didukung. Mereka diidentifikasi dengan nama simbolis formulir GL_LIGHTi di mana i adalah nilai: 0 hingga GL_MAX_LIGHTS - 1.

nama p

Parameter sumber cahaya bernilai tunggal untuk cahaya. Nama simbolik berikut diterima.

Nilai	Makna
GL_SPOT_EXPONENT	Parameter param adalah nilai bilangan bulat tunggal yang menentukan distribusi intensitas cahaya. Nilai bilangan bulat dan titik mengambang dipetakan secara langsung. Hanya nilai dalam rentang [0, 128] yang diterima. Intensitas cahaya yang efektif direda oleh kosinus sudut antara arah cahaya dan arah dari cahaya ke puncak yang dinyalakan, dinaikkan ke kekuatan eksponen spot. Dengan demikian, eksponen spot yang lebih tinggi menghasilkan sumber cahaya yang lebih fokus, terlepas dari sudut pemotongan spot. Eksponen spot default adalah 0, menghasilkan distribusi cahaya yang seragam.
GL_SPOT_CUTOFF	Parameter param adalah nilai bilangan bulat tunggal yang menentukan sudut sebaran maksimum sumber cahaya. Nilai bilangan bulat dan titik mengambang dipetakan secara langsung. Hanya nilai dalam rentang [0, 90], dan nilai khusus 180, yang diterima. Jika sudut antara arah cahaya dan arah dari cahaya ke puncak yang dinyalakan lebih besar dari sudut pemotongan spot, maka cahaya benar-benar tertutup. Jika tidak, intensitasnya dikendalikan oleh eksponen spot dan faktor redaman. Cutoff spot default adalah 180, menghasilkan distribusi cahaya yang seragam.
GL_CONSTANT_ATTENUATION, GL_LINEAR_ATTENUATION, GL_QUADRATIC_ATTENUATION	Parameter param adalah nilai bilangan bulat tunggal yang menentukan salah satu dari tiga faktor pelambatan cahaya. Nilai bilangan bulat dan titik mengambang dipetakan secara langsung. Hanya nilai nonnegatif yang diterima. Jika cahaya posisi, bukan terarah, intensitasnya diredaksi oleh timbal balik dari jumlah: faktor konstanta, faktor linier dikalikan dengan jarak antara cahaya dan puncak yang dinyalakan, dan faktor kuadrat dikalikan dengan kuadrat jarak yang sama. Faktor pelambatan default adalah (1,0,0), sehingga tidak ada redaman.

Param

Menentukan nilai yang akan diatur parameter nama pnamecahaya sumber cahaya.

Menampilkan nilai

Fungsi ini tidak mengembalikan nilai.

Kode kesalahan

Kode kesalahan berikut dapat diambil oleh fungsi glGetError .

Nama	Makna
GL_INVALID_ENUM	light atau pname bukan nilai yang diterima.
GL_INVALID_VALUE	Nilai eksponen spot ditentukan di luar rentang [0, 128], atau pemotongan spot ditentukan di luar rentang [0, 90] (kecuali untuk nilai khusus 180), atau faktor pelepasan negatif ditentukan.
GL_INVALID_OPERATION	Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd.

Keterangan

Fungsi glLighti menetapkan nilai atau nilai parameter sumber cahaya individual. Parameter cahaya menamai cahaya dan merupakan nama simbolis dari formulir GL_LIGHTi, di mana 0 = i< GL_MAX_LIGHTS.

Parameter pname menentukan salah satu parameter sumber cahaya, sekali lagi dengan nama simbolis. Parameter param adalah nilai tunggal atau penunjuk ke array yang berisi nilai baru.

Perhitungan pencahayaan diaktifkan dan dinonaktifkan menggunakan glEnable dan glDisable dengan argumen GL_LIGHTING. Saat pencahayaan diaktifkan, sumber cahaya yang diaktifkan berkontribusi pada perhitungan pencahayaan. Sumber cahaya i diaktifkan dan dinonaktifkan menggunakan glEnable dan glDisable dengan argumen GL_LIGHTi.

Selalu kasus yang GL_LIGHTi = GL_LIGHT0 + i.

Fungsi berikut mengambil informasi yang terkait dengan fungsi glLighti :

glGetLight

glIsEnabled dengan argumen GL_LIGHTING

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

glColorMaterial

glEnd

glLightModel

glMaterial