Baca dalam bahasa Inggris

Bagikan melalui


fungsi glLightf

Fungsi glLightf mengembalikan nilai parameter sumber cahaya.

Sintaks

void WINAPI glLightf(
   GLenum  light,
   GLenum  pname,
   GLfloat 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 floating-point tunggal yang menentukan distribusi intensitas cahaya. Nilai floating-point 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 floating-point tunggal yang menentukan sudut sebaran maksimum sumber cahaya. Nilai floating-point 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 floating-point tunggal yang menentukan salah satu dari tiga faktor redaman cahaya. Nilai floating-point 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.

Mengembalikan 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 glLightf 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 glLightf :

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