glLightiv 函式
glLightiv函式會傳回光源參數值。
語法
void WINAPI glLightiv(
GLenum light,
GLenum pname,
const GLint *params
);
參數
-
light
-
光線的識別碼。 可能的光線數目取決於實作，但至少支援八個光線。 它們是以 i 為值 GL_LIGHT之 i 格式的符號名稱來識別，其中i 是值：0 到 GL_MAX_LIGHTS - 1。
-
pname
-
淺色的光源參數。 接受下列符號名稱。
值 意義 - GL_AMBIENT
params參數包含四個整數值，指定光線的環境 RGBA 濃度。 整數值會以線性方式對應，讓最正表示的值對應至 1.0，而最負數表示的值會對應至 -1.0。 浮點值會直接對應。 整數和浮點值都不會受到限制。 預設的環境光線濃度 (0.0、0.0、0.0、1.0) 。 - GL_DIFFUSE
params參數包含四個整數值，指定光線的擴散 RGBA 濃度。 整數值會以線性方式對應，讓最正表示的值對應至 1.0，而最負數表示的值會對應至 -1.0。 浮點值會直接對應。 整數和浮點值都不會受到限制。 預設擴散濃度是 (0.0、0.0、0.0、1.0) ，適用于光線零以外的所有光線。 光線零的預設擴散濃度是 (1.0、1.0、1.0、1.0) 。 - GL_SPECULAR
params參數包含四個整數值，指定光線的反射 RGBA 濃度。 整數值會以線性方式對應，讓最正表示的值對應至 1.0，而最負數表示的值則對應至 1.0。 浮點值會直接對應。 整數和浮點值都不會受到限制。 預設的反射強度是 (0.0、0.0、0.0、1.0) ，適用于光線零以外的所有光線。 光線零的預設反射強度 (1.0、1.0、1.0、1.0) 。 - GL_POSITION
params參數包含四個整數值，指定光線在同質物件座標中的位置。 整數和浮點值都會直接對應。 整數和浮點值都不會受到限制。
當 呼叫 glLightiv 時，模型檢視矩陣會轉換位置 (就像是點) 一樣，而且會儲存在眼睛座標中。 如果位置的 w 元件是 0.0，則會將光線視為方向來源。 擴散和反射光源計算會採用光線的方向，但不會將其實際位置納入考慮，並停用衰減。 否則，擴散和反射光源計算是根據眼睛座標中光線的實際位置，並啟用衰減。 預設位置 (0，0，1，0) ;因此，預設光源是方向、平行和 -z 軸的方向。- GL_SPOT_DIRECTION
params參數包含三個整數值，指定同質物件座標中光線的方向。 整數和浮點值都會直接對應。 整數和浮點值都不會受到限制。
當 呼叫 glLightiv 時，模型檢視矩陣的反轉會轉換現成方向 (，就像是一般) 一樣，而且會儲存在眼睛座標中。 只有在GL_SPOT_CUTOFF不是預設為 180 時，才很重要。 預設方向為 (0，0，1) 。- GL_SPOT_EXPONENT
params參數是單一整數值，指定光線的濃度分佈。 整數和浮點值會直接對應。 只接受範圍 [0， 128] 中的值。
有效的光線濃度會由光線方向與光線方向之間的余弦值衰減，而從光線到點亮的頂點，會提升為現成指數的乘冪。 因此，不論現成截斷角度為何，較高的點指數都會產生更專注的光源。 預設的現成指數為 0，導致統一光線分佈。- GL_SPOT_CUTOFF
params參數是單一整數值，指定光源的最大散佈角度。 整數和浮點值會直接對應。 只接受範圍 [0， 90] 和特殊值 180 中的值。
如果光線方向與從光線到點光源方向之間的角度大於現成截斷角度，則光線會完全遮罩。 否則，其強度是由現成指數和衰減因數所控制。 預設現成截斷為 180，導致統一光線分佈。- GL_CONSTANT_ATTENUATION、GL_LINEAR_ATTENUATION、GL_QUADRATIC_ATTENUATION
params參數是單一整數值，指定三個光線衰減因數之一。 整數和浮點值會直接對應。 只接受非負值。
如果光線是位置，而不是方向，則其強度會由總和的相互衰減：常數因數、線性因數乘以光線與頂點之間的距離，而二次方因數乘以相同距離的平方。 預設衰減因數 (1，0，0) ，因此不會衰減。 -
params
-
指定將設定為光源光源pname參數的值。
傳回值
此函式不會傳回值。
錯誤碼
glGetError函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
light 或 pname 不是接受的值。 |
|
在範圍 [0， 128] 或現成截斷範圍之外指定了現成指數值 [0， 90] (除了特殊值 180) 之外，或指定負衰減因數。 |
|
在 對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。 |
備註
glLightiv函式會設定個別光源參數的值或值。 light參數會命名光線，而且是 GL_LIGHT i 格式的符號名稱，其中0 = i< GL_MAX_LIGHTS。
pname參數會以符號名稱再次指定其中一個光源參數。 params參數是單一值或包含新值的陣列指標。
使用 glEnable 和 glDisable 搭配引數GL_LIGHTING來啟用和停用光源計算。 啟用光源時，啟用的光源會參與光源計算。 使用glEnable和glDisable搭配引數 GL_LIGHT i 啟用和停用光源i。
GL_LIGHTi = GL_LIGHT0 + i一律是這種情況。
下列函式會擷取 與 glLightiv 函式相關的資訊：
glIsEnabled 搭配引數GL_LIGHTING
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|