glPushName 函式

glPushName和glPopName函式會推送並快顯名稱堆疊。

語法

void WINAPI glPushName(
   GLuint name
);

此函式不會傳回值。

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

名稱	意義
GL_STACK_OVERFLOW	在目前的矩陣堆疊已滿時呼叫函式。
GL_INVALID_OPERATION	函式是在對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

glPushName函式會導致名稱推送至名稱堆疊，這一開始是空的。 glPopName函式會在堆疊頂端快顯一個名稱。名稱堆疊會在選取模式期間使用，以允許唯一識別一組轉譯命令。它是由一組未帶正負號的整數所組成。

當轉譯模式未GL_SELECT時，名稱堆疊一律是空的。當轉譯模式未GL_SELECT忽略時，對 glPushName 或 glPopName 的呼叫。

下列函式會擷取 與 glPushName 和 glPopName相關的資訊：

glGet with argument GL_NAME_STACK_DEPTH

glGet with argument GL_MAX_NAME_STACK_DEPTH

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