glLoadName

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glLoadName


glLoadName


glLoadName - lädt einen Namen auf den Namestack.

Delphi-Spezifikation


procedure glLoadName(name : GLuint);


Parameter


name Stellt den Namen dar, der auf den Stack gelegt werden soll.


Beschreibung


Der Namestack wird im Selectionmode benutzt um eine Menge von Renderbefehlen eindeutig zu identifizieren. Der Namestack besteht aus einer Menge von vorzeichenlosen Ganzzahlen (unsigned integer). Durch die Funktion glLoadName wird name auf den Stack gelegt und bildet damit die neue Spitze des Stacks (der nach der Initialisierung leer ist).

(Wörtlich übersetzt "ersetzt name das Topelement des Stacks". Da dies aber Datenverlust bedeuten würde habe ich es anders übersetzt. Bitte um überprüfung.)


Hinweise


Solange der Rendermodus nicht GL_SELECT ist, ist der Namestack leer.
Aufrufe von glLoadName werden ignoriert wenn der Rendermodus nich GL_SELECT ist.



Fehlermeldungen


GL_FEHLER wird generiert wenn glLoadName bei leerem Namestack aufgerufen wird.
GL_INVALID_OPERATION wird generiert wenn glLoadName innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Zugehörige Wertrückgaben


glGet mit Token GL_NAME_STACK_DEPTH
glGet mit Token GL_MAX_NAME_STACK_DEPTH


Siehe auch


glInitNames, glPushName, glRenderMode, glSelectBuffer