fungsi glGetLightiv

Fungsi glGetLightfv dan glGetLightiv mengembalikan nilai parameter sumber cahaya.

Sintaks

void WINAPI glGetLightiv(
   GLenum light,
   GLenum pname,
   GLint  *params
);

Parameter

Cahaya

Sumber cahaya. Jumlah kemungkinan lampu tergantung pada implementasinya, tetapi setidaknya delapan lampu didukung. Mereka diidentifikasi dengan nama simbolis formulir GL_LIGHT i di mana 0 = i< GL_MAX_LIGHTS.

nama p

Parameter sumber cahaya untuk cahaya. Nama simbolik berikut diterima.

Nilai	Makna
GL_AMBIENT	Parameter params mengembalikan empat nilai bilangan bulat atau floating-point yang mewakili intensitas sekitar sumber cahaya. Nilai bilangan bulat, ketika diminta, dipetakan secara linier dari representasi floating-point internal sedih sehingga 1,0 memetakan ke nilai bilangan bulat yang paling positif yang dapat diwakili, dan -1,0 memetakan ke nilai bilangan bulat yang paling negatif yang dapat diwakili. Jika nilai internal berada di luar rentang [-1,1], nilai pengembalian bilangan bulat yang sesuai tidak ditentukan.
GL_DIFFUSE	Parameter params mengembalikan empat nilai bilangan bulat atau floating-point yang mewakili intensitas difus sumber cahaya. Nilai bilangan bulat, ketika diminta, dipetakan secara linier dari representasi floating-point internal sedih sehingga 1,0 memetakan ke nilai bilangan bulat yang paling positif yang dapat diwakili, dan -1,0 memetakan ke nilai bilangan bulat yang paling negatif yang dapat diwakili. Jika nilai internal berada di luar rentang [-1,1], nilai pengembalian bilangan bulat yang sesuai tidak ditentukan.
GL_SPECULAR	Parameter params mengembalikan empat nilai bilangan bulat atau floating-point yang mewakili intensitas spekular sumber cahaya. Nilai bilangan bulat, ketika diminta, dipetakan secara linier dari representasi floating-point internal sedih sehingga 1,0 memetakan ke nilai bilangan bulat yang paling positif yang dapat diwakili, dan -1,0 memetakan ke nilai bilangan bulat yang paling negatif yang dapat diwakili. Jika nilai internal berada di luar rentang [-1,1], nilai pengembalian bilangan bulat yang sesuai tidak ditentukan.
GL_POSITION	Parameter params mengembalikan empat nilai bilangan bulat atau floating-point yang mewakili posisi sumber cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan nilai floating-point internal ke nilai bilangan bulat terdekat. Nilai yang dikembalikan adalah nilai yang dipertahankan dalam koordinat mata. Nilai tersebut tidak akan sama dengan nilai yang ditentukan menggunakan glLight, kecuali matriks tampilan model diidentifikasi pada saat glLight dipanggil.
GL_SPOT_DIRECTION	Parameter params mengembalikan tiga nilai bilangan bulat atau floating-point yang mewakili arah sumber cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan nilai floating-point internal ke nilai bilangan bulat terdekat. Nilai yang dikembalikan adalah nilai yang dipertahankan dalam koordinat mata. Nilai tersebut tidak akan sama dengan nilai yang ditentukan menggunakan glLight, kecuali matriks tampilan model diidentifikasi pada saat glLight dipanggil. Meskipun arah spot dinormalisasi sebelum digunakan dalam persamaan pencahayaan, nilai yang dikembalikan adalah versi yang diubah dari nilai yang ditentukan sebelum normalisasi.
GL_SPOT_EXPONENT	Parameter params mengembalikan nilai bilangan bulat tunggal atau floating-point yang mewakili eksponen spot cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan representasi floating-point internal ke bilangan bulat terdekat.
GL_SPOT_CUTOFF	Parameter params mengembalikan nilai bilangan bulat tunggal atau floating-point yang mewakili sudut pemotongan spot cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan representasi floating-point internal ke bilangan bulat terdekat.
GL_CONSTANT_ATTENUATION	Parameter params mengembalikan satu bilangan bulat atau nilai floating-point yang mewakili peledakan konstanta (tidak terkait jarak) dari cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan representasi floating-point internal ke bilangan bulat terdekat.
GL_LINEAR_ATTENUATION	Parameter params mengembalikan nilai bilangan bulat tunggal atau floating-point yang mewakili redaman linier cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan representasi floating-point internal ke bilangan bulat terdekat.
GL_QUADRATIC_ATTENUATION	Parameter params mengembalikan satu bilangan bulat atau nilai floating-point yang mewakili redaman kuadrat cahaya. Nilai bilangan bulat, saat diminta, dihitung dengan membulatkan representasi floating-point internal ke bilangan bulat terdekat.

params

Mengembalikan data yang diminta.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Fungsi glGetLight mengembalikan nilai atau nilai parameter sumber cahaya dalam param . Parameter cahaya menamai cahaya dan merupakan nama simbolis dari formulir GL_LIGHTi untuk 0 = i< GL_MAX_LIGHTS, di mana GL_MAX_LIGHTS adalah konstanta dependen implementasi yang lebih besar dari atau sama dengan delapan. Parameter pname menentukan salah satu dari sepuluh parameter sumber cahaya, sekali lagi dengan nama simbolis.

Selalu kasus yang GL_LIGHTi = GL_LIGHT0 + i.

Jika kesalahan dihasilkan, tidak ada perubahan yang dilakukan pada konten param.

Persyaratan

Lihat juga

glBegin

glEnd

glLight