- load a name onto the name stack



C SPECIFICATION


PARAMETERS

       _param1  Specifies  a name that will replace the top value
                on the name stack.


DESCRIPTION

       The name stack is used during selection mode to allow sets
       of  rendering commands to be uniquely identified.  It con-
       sists of an ordered set of unsigned integers.   glLoadName
       causes _param1 to replace the value on the top of the name
       stack, which is initially empty.

       The name stack is always empty while the  render  mode  is
       not  GL_SELECT.  Calls to glLoadName while the render mode
       is not GL_SELECT are ignored.


ERRORS

       GL_INVALID_OPERATION is generated if glLoadName is  called
       while the name stack is empty.

       GL_INVALID_OPERATION  is  generated  if glLoadName is exe-
       cuted between the execution of glBegin and the correspond-
       ing execution of glEnd.


ASSOCIATED GETS

       glGet with argument GL_NAME_STACK_DEPTH
       glGet with argument GL_MAX_NAME_STACK_DEPTH


SEE ALSO

       glInitNames, glPushName, glRenderMode, glSelectBuffer



                                                                1