Bezeichnung
gl.PushName -- verschiebt den Namensstapel
Übersicht
gl.PushName(name)
Beschreibung
Der Namensstapel wird im Auswahlmodus verwendet, um eine eindeutige Identifizierung von Renderingbefehlen zu ermöglichen. Er besteht aus einem geordneten Satz von vorzeichenlosen Ganzzahlen und ist zunächst leer.

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.

Eingaben
name
gibt einen Namen an, der auf den Namensstapel geschoben wird
Fehler
#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.

Verbundene get-operationen
gl.Get() mit dem Argument #GL_NAME_STACK_DEPTH

gl.Get() mit dem Argument #GL_MAX_NAME_STACK_DEPTH


Navigation zeigen