Light | Dark

# docs.GL

OpenGL 3
OpenGL 2

# glLoadName

## Name

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 https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.

Think you can improve this page? Edit this page on GitHub.