gl.PushName(name)
gl.PushName()
bewirkt, dass der Name auf den Namensstapel geschoben wird.
Die maximale Tiefe des Namensstapels ist implementierungsabhängig; rufen Sie
#GL_MAX_NAME_STACK_DEPTH
auf, um den Wert für eine bestimmte Implementierung
herauszufinden.
Es ist ein Fehler, einen Namen auf einen vollen Stapel zu schieben. Es ist auch ein Fehler, den Namensstapel zwischen der Ausführung von gl.Begin() und gl.End() zu manipulieren. In jedem dieser Fälle wird das Fehlerflag gesetzt und es wird keine weitere Änderung des GL-Zustandes vorgenommen.
Der Namensstapel ist immer leer, wenn der Rendermodus nicht #GL_SELECT
ist. Aufrufe von gl.PushName()
, wenn der Rendermodus nicht #GL_SELECT
ist, werden ignoriert.
Weitere Informationen finden Sie in einem OpenGL-Referenzhandbuch.
#GL_STACK_OVERFLOW
wird erzeugt, wenn gl.PushName()
aufgerufen wird,
während der Namensstapel voll ist.
#GL_INVALID_OPERATION
wird erzeugt, wenn gl.PushName()
zwischen
gl.Begin() und gl.End() ausgeführt wird.
#GL_NAME_STACK_DEPTH
gl.Get() mit dem Argument #GL_MAX_NAME_STACK_DEPTH