glPushName-Funktion

Die Funktionen glPushName und glPopName pushen und popen den Namensstapel.

Syntax

void WINAPI glPushName(
   GLuint name
);

Parameter

name

Ein Name, der in den Namensstapel gepusht 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.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glPushName-Funktion bewirkt, dass name in den Namenstapel gepusht wird, der zunächst leer ist. Die glPopName-Funktion füllt einen Namen am Anfang des Stapels ein. Der Namensstapel wird während des Auswahlmodus verwendet, um eine eindeutige Identifizierung von Renderingbefehlen zu ermöglichen. Sie besteht aus einem sortierten 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

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

Siehe auch

glBegin

glEnd

glInitNames

glLoadName

glRenderMode

glSelectBuffer