glPushClientAttrib 函式
glPushClientAttrib和glPopClientAttrib函式會儲存和還原用戶端屬性堆疊上的用戶端狀態變數群組。
語法
void WINAPI glPushClientAttrib(
GLbitfield mask
);
參數
-
mask
-
遮罩，表示要儲存的屬性。 以下是符號遮罩常數及其相關聯的 OpenGL 用戶端狀態。
值 意義 - GL_CLIENT_PIXEL_STORE_BIT
圖元儲存模式屬性。 - GL_CLIENT_VERTEX_ARRAY_BIT
頂點陣列屬性。 - GL_CLIENT_ALL_ATTRIB_BITs
所有可堆疊用戶端狀態屬性。
傳回值
此函式不會傳回值。
錯誤碼
glGetError函式可以擷取下列錯誤碼。
| 名稱 | 意義 |
|---|---|
|
函式是在用戶端屬性堆疊已滿時呼叫。 |
備註
glPushClientAttrib函式會使用其 mask 參數來判斷用戶端狀態變數群組會儲存在用戶端屬性堆疊上。 您可以使用位 OR 運算子將接受的符號常數聯結在一起，以設定位並建構遮罩。
glPopClientAttrib函式會還原上次與glPushclientAttrib一起儲存的用戶端狀態變數值。 先前未儲存的用戶端狀態變數會保持不變。 將屬性推送至完整的用戶端屬性堆疊，或從空堆疊取出屬性會設定錯誤旗標，而且不會對 OpenGL 狀態進行任何其他變更。 根據預設，用戶端屬性堆疊是空的。
某些 OpenGL 用戶端狀態值無法儲存在用戶端屬性堆疊上。 例如，您無法在用戶端屬性堆疊上儲存選取或意見反應狀態。 用戶端屬性堆疊的深度至少為 16。
glPushclientAttrib和glPopClientAttrib函式不會編譯成顯示清單，但會立即執行。
glPushClientAttrib和glPopClientAttrib函式只能推送和快顯圖元儲存模式和頂點陣列用戶端狀態。 您必須使用 glPushAttrib 和 glPopAttrib 來推送和快顯伺服器上保留的狀態。
注意
glPushClientAttrib和glPopClientAttrib函式僅適用于 OpenGL 1.1 版或更新版本。
下列函式會擷 取與 glPushClientAttrib 和 glPopClientAttrib相關的資訊：
glGet with argument GL_CLIENT_ATTRIB_STACK_DEPTH
具有引數的glGet GL_MAX_CLIENT_ATTRIB_STACK_DEPTH
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|