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函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
func 不是可接受的值。 |
|
函式是在 對 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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|