glPopName-Funktion
Die Funktionen glPushName und glPopName pushen und popen den Namensstapel.
Syntax
void WINAPI glPopName(void);
Parameter
Diese Funktion besitzt keine Parameter.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Funktion wurde aufgerufen, während der aktuelle Matrixstapel nur eine einzige Matrix enthielt. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen. |
Bemerkungen
Die glPushName-Funktion bewirkt, dass name auf den Namenstapel gepusht wird, der anfänglich leer ist. Die glPopName-Funktion entfernt einen Namen am anfang des Stapels. Der Namensstapel wird während des Auswahlmodus verwendet, damit Sätze von Renderingbefehlen eindeutig identifiziert werden können. Sie besteht aus einer geordneten Gruppe von ganzen Zahlen ohne Vorzeichen.
Der Namensstapel ist immer leer, während der Rendermodus nicht GL _ SELECT lautet. 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 |
|
| Bibliothek |
|
| DLL |
|