glLoadName 函式

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

語法

void WINAPI glLoadName(
   GLuint name
);

參數

name

名稱,將取代名稱堆疊上的頂端值。

傳回值

此函式不會傳回值。

錯誤碼

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

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

備註

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

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

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

glGet with argument GL_NAME_STACK_DEPTH

glGet 搭配引數GL_MAX_NAME_STACK_DEPTH

規格需求

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

另請參閱

glBegin

glEnd

glInitNames

glPushName

glRenderMode

glSelectBuffer