glAlphaFunc 函式

glAlphaFunc函式可讓您的應用程式設定 Alpha 測試函式。

語法

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

參數

func

Alpha 比較函式。 以下是可接受的符號常數及其意義。

值	意義
GL_NEVER	永不通過。
GL_LESS	如果傳入 Alpha 值小於參考值，則傳遞 。
GL_EQUAL	如果傳入 Alpha 值等於參考值，則傳遞 。
GL_LEQUAL	如果傳入 Alpha 值小於或等於參考值，則傳遞 。
GL_GREATER	如果傳入 Alpha 值大於參考值，則傳遞 。
GL_NOTEQUAL	如果傳入 Alpha 值不等於參考值，則傳遞 。
GL_GEQUAL	如果傳入 Alpha 值大於或等於參考值，則傳遞 。
GL_ALWAYS	一律通過。 此為預設值。

ref

要比較傳入 Alpha 值的參考值。 這個值會限制為範圍 0 到 1，其中 0 代表最低的可能 Alpha 值，而 1 表示最高的可能值。 預設參考為 0。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

Alpha 測試會根據傳入片段的 Alpha 值與常數參考值之間的比較結果，捨棄片段。 glAlphaFunc函式會指定參考和比較函式。 只有在啟用 Alpha 測試時，才會執行比較。 (如需GL_ALPHA_TEST的詳細資訊，請參閱 glEnable.)

func和ref參數會指定繪製圖元的條件。 使用func指定的函式，將傳入 Alpha 值與ref進行比較。 如果比較通過，則會繪製傳入片段，並依據後續樣板和深度緩衝區測試的條件。 如果比較失敗，則不會對該圖元位置的框架緩衝區進行任何變更。

glAlphaFunc函式會在所有圖元寫入上運作，包括從點、線條、多邊形和點陣圖的掃描轉換，以及圖元繪製和複製作業所產生的寫入。 glAlphaFunc函式不會影響螢幕清除作業。

Alpha 測試只能在 RGBA 模式中完成。

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

具有引數的glGet GL_ALPHA_TEST_FUNC

glGet with argument GL_ALPHA_TEST_REF

glIsEnabled with argument GL_ALPHA_TEST

規格需求

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

另請參閱

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc