1991-2006
Silicon Graphics, Inc.
glLoadName
3G

# glLoadName

load a name onto the name stack

## C Specification

                    void glLoadName
                    GLuint name

## Parameters

`name`

  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 consists of an ordered set of unsigned integers and is initially empty.

`glLoadName` causes `name` to replace the value on the top of the name stack.

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 executed between the execution of glBegin and the corresponding 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

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.