glLoadName 函式

glLoadName函式會將名稱載入至名稱堆疊。

語法

void WINAPI glLoadName(
   GLuint name
);

此函式不會傳回值。

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

名稱	意義
GL_INVALID_OPERATION	在名稱堆疊是空的時呼叫函式。
GL_INVALID_OPERATION	函式是在對 glBegin 的呼叫和 glEnd的對應呼叫之間呼叫。

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

當轉譯模式未GL_SELECT時，名稱堆疊一律是空的。當轉譯模式未GL_SELECT時，會忽略 glLoadName 的呼叫。

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

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