glLightf 函式

glLightf 函式會傳回光源參數值。

語法

void WINAPI glLightf(
   GLenum  light,
   GLenum  pname,
   GLfloat param
);

light

光線的識別碼。可能的光線數目取決於實作，但至少支援八個光線。它們是以 i 為值 GL_LIGHT之 i 格式的符號名稱來識別，其中i 是值：0 到 GL_MAX_LIGHTS - 1。

pname

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

值	意義
GL_SPOT_EXPONENT	param參數是單一浮點值，指定光線的濃度分佈。浮點值會直接對應。只接受範圍 [0， 128] 中的值。有效的光線濃度會由光線方向與光線方向之間的余弦值衰減，而從光線到點亮的頂點，會提升為現成指數的乘冪。因此，不論現成截斷角度為何，較高的點指數都會產生更專注的光源。預設的現成指數為 0，導致統一光線分佈。
GL_SPOT_CUTOFF	param參數是單一浮點值，指定光源的最大散佈角度。浮點值會直接對應。只接受範圍 [0， 90] 和特殊值 180 中的值。如果光線方向與從光線到點光源方向之間的角度大於現成截斷角度，則光線會完全遮罩。否則，其強度是由現成指數和衰減因數所控制。預設現成截斷為 180，導致統一光線分佈。
GL_CONSTANT_ATTENUATION、GL_LINEAR_ATTENUATION、GL_QUADRATIC_ATTENUATION	param參數是單一浮點值，指定三個光線衰減因數的其中一個。浮點值會直接對應。只接受非負值。如果光線是位置，而不是方向，則其強度會由總和的相互衰減：常數因數、線性因數乘以光線與頂點之間的距離，而二次方因數乘以相同距離的平方。預設衰減因數 (1，0，0) ，因此不會衰減。

param

指定將設定為光源光源pname參數的值。

此函式不會傳回值。

glGetError函式可以擷取下列錯誤碼。

名稱	意義
GL_INVALID_ENUM	light 或 pname 不是接受的值。
GL_INVALID_VALUE	在範圍 [0， 128] 或現成截斷範圍之外指定了現成指數值 [0， 90] (除了特殊值 180) 之外，或指定負衰減因數。
GL_INVALID_OPERATION	在對 glBegin 的呼叫與 glEnd的對應呼叫之間呼叫函式。

glLightf 函式會設定個別光源參數的值或值。 light參數會命名光線，而且是 GL_LIGHT i 格式的符號名稱，其中0 = i< GL_MAX_LIGHTS。

pname參數會以符號名稱再次指定其中一個光源參數。 param參數是單一值或包含新值的陣列指標。

使用 glEnable 和 glDisable 搭配引數GL_LIGHTING來啟用和停用光源計算。啟用光源時，啟用的光源會參與光源計算。使用glEnable和glDisable搭配引數 GL_LIGHT i 啟用和停用光源i。

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

下列函式會擷取 與 glLightf 函式相關的資訊：

glIsEnabled 搭配引數GL_LIGHTING