Função glLoadName

A função glLoadName carrega um nome na pilha de nomes.

Sintaxe

void WINAPI glLoadName(
   GLuint name
);

Parâmetros

name

Um nome que substituirá o valor superior na pilha de nomes.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome Significado
GL_INVALID_OPERATION
A função foi chamada enquanto a pilha de nomes estava vazia.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glLoadName faz com que o nome substitua o valor na parte superior da pilha de nomes, que está inicialmente vazia. A pilha de nomes é usada durante o modo de seleção para permitir que conjuntos de comandos de renderização sejam identificados exclusivamente. Ele consiste em um conjunto ordenado de inteiros sem sinal.

A pilha de nomes está sempre vazia enquanto o modo de renderização não é GL_SELECT. Chamadas para glLoadName enquanto o modo de renderização não é GL_SELECT são ignoradas.

As seguintes funções recuperam informações relacionadas ao glLoadName:

glGet com GL_NAME_STACK_DEPTH de argumento

glGet com GL_MAX_NAME_STACK_DEPTH de argumento

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnd

glInitNames

glPushName

glRenderMode

glSelectBuffer