glGetLightfv 函式

glGetLightfv和glGetLightiv函式會傳回光源參數值。

語法

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

參數

light

光源。 可能的光線數目取決於實作，但至少支援八個光線。 它們是以 i 格式的符號名稱來識別GL_LIGHT i，其中 0 = i< GL_MAX_LIGHTS。

pname

光線的光源參數。 接受下列符號名稱。

值	意義
GL_AMBIENT	params參數會傳回四個整數或浮點值，代表光源的環境強度。 要求時，整數值會以線性方式從內部浮點表示對應，讓 1.0 對應到最正表示的整數值，而 -1.0 則對應到最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值是未定義的。
GL_DIFFUSE	params參數會傳回四個整數或浮點值，代表光源的擴散強度。 要求時，整數值會以線性方式從內部浮點表示對應，讓 1.0 對應到最正表示的整數值，而 -1.0 則對應到最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值是未定義的。
GL_SPECULAR	params參數會傳回四個整數或浮點值，代表光源的反射強度。 要求時，整數值會以線性方式從內部浮點表示對應，讓 1.0 對應到最正表示的整數值，而 -1.0 則對應到最負數的可表示整數值。 如果內部值超出範圍 [-1，1]，則對應的整數傳回值是未定義的。
GL_POSITION	params參數會傳回四個整數或浮點值，代表光源的位置。 當要求時，整數值會透過將內部浮點值四捨五入到最接近的整數值來計算。 傳回的值是在眼睛座標中維護的值。 除非在呼叫 glLight時識別 modelview 矩陣，否則它們不會等於使用 glLight 指定的值。
GL_SPOT_DIRECTION	params參數會傳回三個整數或浮點值，代表光源的方向。 當要求時，整數值會透過將內部浮點值四捨五入到最接近的整數值來計算。 傳回的值是在眼睛座標中維護的值。 除非在呼叫 glLight時識別 modelview 矩陣，否則它們不會等於使用 glLight 指定的值。 雖然現成方向會在光源方程式中使用之前正規化，但傳回的值是在正規化之前轉換的指定值版本。
GL_SPOT_EXPONENT	params參數會傳回單一整數或浮點值，代表光線的現成指數。 當要求時，會將內部浮點表示四捨五入為最接近的整數，以計算整數值。
GL_SPOT_CUTOFF	params參數會傳回單一整數或浮點值，代表光線的現成截斷角度。 當要求時，會將內部浮點表示四捨五入為最接近的整數，以計算整數值。
GL_CONSTANT_ATTENUATION	params參數會傳回單一整數或浮點值，代表與光線不相關的常數 (與距離相關的) 衰減。 當要求時，會將內部浮點表示四捨五入為最接近的整數，以計算整數值。
GL_LINEAR_ATTENUATION	params參數會傳回單一整數或浮點值，代表光線的線性衰減。 當要求時，會將內部浮點表示四捨五入為最接近的整數，以計算整數值。
GL_QUADRATIC_ATTENUATION	params參數會傳回單一整數或浮點值，代表光線的二次衰減。 當要求時，會將內部浮點表示四捨五入為最接近的整數，以計算整數值。

params

傳回要求的資料。

傳回值

此函式不會傳回值。

備註

glGetLight函式會在參數中傳回光源參數的值或值。 light參數會將光線命名為 light，而且是 i < GL_LIGHTi GL_MAX_LIGHTS格式的符號名稱，其中 GL_MAX_LIGHTS 是大於或等於 8 的實作相依常數。 pname參數會以符號名稱再次指定十個光源參數的其中一個。

GL_LIGHTi = GL_LIGHT0 + i一律是這種情況。

如果產生錯誤，則 不會變更參數的內容。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Gl.h
程式庫	Opengl32.lib
DLL	Opengl32.dll

另請參閱

glBegin

glEnd

glLight