---
name: "glLoadName"
section: "3x"
platform: "linux"
package: "xlibmesa-gl-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/glLoadName"
---

# glLoadName(3x)

load a name onto the name stack

## 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. **glLoadName** causes *name* 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 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(3G)**, **glPushName(3G)**, **glRenderMode(3G)**, **glSelectBuffer(3G)**