fungsi glLighti
Fungsi glLighti mengembalikan nilai parameter sumber cahaya.
void WINAPI glLighti(
GLenum light,
GLenum pname,
GLint param
);
-
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.
Fungsi ini tidak mengembalikan nilai.
Kode kesalahan berikut dapat diambil oleh fungsi glGetError .
Nama | Makna |
---|---|
|
light atau pname bukan nilai yang diterima. |
|
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. |
|
Fungsi ini dipanggil antara panggilan ke glBegin dan panggilan yang sesuai ke glEnd. |
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 :
glIsEnabled dengan argumen GL_LIGHTING
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|
Pustaka |
|
DLL |
|