Função glPushName

As funções glPushName e glPopName efetuam push e pop da pilha de nomes.

Sintaxe

void WINAPI glPushName(
   GLuint name
);

Parâmetros

name

Um nome que será enviado por push para a 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_STACK_OVERFLOW
A função foi chamada enquanto a pilha de matriz atual estava cheia.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glPushName faz com que o nome seja enviado por push para a pilha de nomes, que está inicialmente vazia. A função glPopName exibe um nome na parte superior da pilha. 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 glPushName ou glPopName enquanto o modo de renderização não é GL_SELECT são ignoradas.

As seguintes funções recuperam informações relacionadas a glPushName e glPopName:

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

glLoadName

glRenderMode

glSelectBuffer