glPopName(3gl)

1GLPUSHNAME(3G)                                                  GLPUSHNAME(3G)
2
3
4

NAME

6       glPushName, glPopName - push and pop the name stack
7
8

C SPECIFICATION

10       void glPushName( GLuint name )
11
12

PARAMETERS

14       name  Specifies a name that will be pushed onto the name stack.
15

C SPECIFICATION

17       void glPopName( void )
18
19

DESCRIPTION

21       The name stack is used during selection mode to allow sets of rendering
22       commands to be uniquely identified.  It consists of an ordered  set  of
23       unsigned integers and is initially empty.
24
25       glPushName  causes  name  to  be pushed onto the name stack.  glPopName
26       pops one name off the top of the stack.
27
28       The  maximum  name  stack  depth  is   implementation-dependent;   call
29       GL_MAX_NAME_STACK_DEPTH  to  find out the value for a particular imple‐
30       mentation. It is an error to push a name onto a full stack, or to pop a
31       name  off  an  empty stack.  It is also an error to manipulate the name
32       stack between the execution of glBegin and the corresponding  execution
33       of  glEnd.   In  any of these cases, the error flag is set and no other
34       change is made to GL state.
35
36       The name stack is always empty while the render mode is not  GL_SELECT.
37       Calls to glPushName or glPopName while the render mode is not GL_SELECT
38       are ignored.
39

ERRORS

41       GL_STACK_OVERFLOW is generated if glPushName is called while  the  name
42       stack is full.
43
44       GL_STACK_UNDERFLOW  is  generated if glPopName is called while the name
45       stack is empty.
46
47       GL_INVALID_OPERATION is generated if glPushName or  glPopName  is  exe‐
48       cuted between a call to glBegin and the corresponding call to glEnd.
49

ASSOCIATED GETS

51       glGet with argument GL_NAME_STACK_DEPTH
52       glGet with argument GL_MAX_NAME_STACK_DEPTH
53