glFogfv 函式

glFogfv函式會指定隱含參數。

語法

void WINAPI glFogfv(
         GLenum  pname,
   const GLfloat *params
);

參數

pname

指定水氣參數。

接受下列其中一個值。

值	意義
GL_FOG_MODE	params參數是浮點值，指定要用來計算水混色因數f的方程式。 接受三個符號常數：GL_LINEAR、GL_EXP和GL_EXP2。 對應至這些符號常數的方程式定義于下列一節中。 預設的GL_EXP模式。
GL_FOG_DENSITY	params參數是一個浮點值，可指定密度，這是這兩個指數型模糊方程式中使用的濕度密度。 只接受非負密度。 預設的濕度密度為 1.0。
GL_FOG_START	params參數是一個浮點值，可指定線性模糊方程式中使用的距離起點。 預設接近距離為 0.0。
GL_FOG_END	params參數是一個浮點值，可指定結束，也就是線性模糊方程式中使用的遠距離。 預設距離為 1.0。
GL_FOG_INDEX	params參數是一個浮點值，指定if ，即水氣色彩索引。 預設的霧索引為 0.0。
GL_FOG_COLOR	params參數包含四個浮點值，可指定Cf ，即水氣色彩。 整數值會以線性方式對應，使最正面的可表示值對應至 1.0，而最負數的可表示值則對應至 -1.0。 浮點值會直接對應。 轉換之後，所有色彩元件都會固定到範圍 [0，1]。 預設的 (為 0，0，0，0，0) 。

params

指定要指派給 pname的值或值。 GL_FOG_COLOR需要四個值的陣列。 所有其他參數都接受只包含單一值的陣列。

傳回值

此函式不會傳回值。

錯誤碼

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

名稱	意義
GL_INVALID_ENUM	pname 不是可接受的值。
GL_INVALID_OPERATION	函式是在 對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

備註

您可以使用引數GL_FOG，啟用和停用 glEnable 和 glDisable的霧。 啟用時，濕度會影響點陣化幾何、點陣圖和圖元區塊，但不會影響緩衝清除作業。

glFogfv函式會將參數中的值或值指派給pname所指定的模糊參數。

水氣會使用混合因數 f來混合每一個點陣化圖元片段的後文色彩。 Factor f 的計算方式有三種，視水氣模式而定。 讓 z 成為眼球座標從原點到被水化片段的距離。 GL_LINEAR水的方程式如下：

GL_EXP水的方程式如下：

GL_EXP2水的方程式如下：

不論水模式為何， f 都會在計算後限制為範圍 [0，1]。 然後，如果 OpenGL 處於 RGBA 色彩模式，片段的色彩 C_r 會取代為

在色彩索引模式中，片段的色彩索引 i_r 會取代為

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

具有引數的glGet GL_FOG_COLOR

glGet with argument GL_FOG_INDEX

glGet with argument GL_FOG_DENSITY

glGet with argument GL_FOG_START

glGet with argument GL_FOG_END

glGet with argument GL_FOG_MODE

glIsEnabled with argument GL_FOG

規格需求

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

另請參閱

glBegin

glDisable

glEnable

glEnd

glGet

glIsEnabled