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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|