glPushName-Funktion

Die Funktionen glPushName und glPopName pushen und poppen den Namenstapel.

Syntax

void WINAPI glPushName(
   GLuint name
);

Parameter

name

Ein Name, der auf den Namensstapel pusht wird.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ STACK _ OVERFLOW
Die Funktion wurde aufgerufen, während der aktuelle Matrixstapel voll war.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glPushName-Funktion bewirkt, dass name auf den Namenstapel pusht wird, der anfänglich leer ist. Die glPopName-Funktion popt einen Namen aus dem Stapel. Der Namensstapel wird im Auswahlmodus verwendet, um eine eindeutige Bezeichnung von Sätzen von Renderingbefehlen zu ermöglichen. Sie besteht aus einem geordneten Satz von ganzen Zahlen ohne Vorzeichen.

Der Namensstapel ist immer leer, während der Rendermodus nicht GL _ SELECT ist. Aufrufe von glPushName oder glPopName, während der Rendermodus nicht GL _ SELECT ist, werden ignoriert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glPushName und glPopName ab:

glGet mit Argument GL _ NAME STACK _ _ DEPTH

glGet mit Argument GL _ MAX NAME STACK _ _ _ DEPTH

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd

glInitNames

glLoadName

glRenderMode

glSelectBuffer