glPushName: Unterschied zwischen den Versionen
(→Beschreibung) |
K (Kategorisierung; Ergänzung der Fehlermeldungen) |
||
| (5 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | + | =glPushName, glPopName= | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | == Name == | |
| − | ===Parameter | + | |
| − | + | '''glPushName, glPopName''' - setzt bzw. nimmt einen Eintrag vom [[Stack|Namenstack]]. | |
| + | |||
| + | |||
| + | |||
| + | |||
| + | == Delphi-Spezifikation == | ||
| + | |||
| + | '''procedure''' glPushName(''name'': GLuint); | ||
| + | '''procedure''' glPopName(); | ||
| + | |||
| + | |||
| + | |||
| + | ==Parameter== | ||
| + | |||
{| border="1" rules="all" | {| border="1" rules="all" | ||
! ''name'' | ! ''name'' | ||
| − | | Der Eintrag der auf dem Namenstack hinzugefügt werden soll. | + | | Der Eintrag, der auf dem Namenstack hinzugefügt werden soll. |
|} | |} | ||
| − | + | ||
| − | + | ||
| − | + | == Beschreibung == | |
| − | Unter einem Namen sollte man in diesem Fall nicht an einen String denken, sondern an eine Zahl in Form einer ID. Der Namenstack wird während des [[glRenderMode |Selektions-Modus]] benutzt um eine eindeutige Identifizierung von Render-Anweisungen | + | Unter einem Namen sollte man in diesem Fall nicht an einen String denken, sondern an eine Zahl in Form einer ID. Der Namenstack wird während des [[glRenderMode |Selektions-Modus]] benutzt, um eine eindeutige Identifizierung von Render-Anweisungen zu ermöglichen. Der Namestack besteht aus vorzeichenlosen Integern und ist zu Beginn leer. |
'''glPushName''' fügt einen neuen Namen dem Stack hinzu, während '''glPopName''' den obersten Eintrag vom Stack entfernt. | '''glPushName''' fügt einen neuen Namen dem Stack hinzu, während '''glPopName''' den obersten Eintrag vom Stack entfernt. | ||
| Zeile 31: | Zeile 35: | ||
Der Namenstack ist immer leer, wenn der [[glRenderMode|Rendermodus]] nicht '''GL_SELECT''' entspricht. Aufrufe von '''glPushName''' oder '''glPopName''' werden werden ebenfalls ignoriert, sollte der Rendermodus nicht auf '''GL_SELECT''' gesetzt sein. | Der Namenstack ist immer leer, wenn der [[glRenderMode|Rendermodus]] nicht '''GL_SELECT''' entspricht. Aufrufe von '''glPushName''' oder '''glPopName''' werden werden ebenfalls ignoriert, sollte der Rendermodus nicht auf '''GL_SELECT''' gesetzt sein. | ||
| − | === | + | |
| − | + | ||
| − | *glGet mit dem Argument GL_NAME_STACK_DEPTH | + | == Fehlermeldungen == |
| − | *glGet mit dem Argument GL_MAX_NAME_STACK_DEPTH | + | '''GL_STACK_OVERFLOW''' wird generiert, falls '''glPushName''' aufgerufen wird, während der Namenstack voll ist. |
| − | + | ||
| − | + | '''GL_STACK_UNDERFLOW''' wird generiert, wenn '''glPopName''' aufgerufen wird, während der Namenstack leer ist. | |
| − | + | ||
| + | '''GL_INVALID_OPERATION''' wird generiert, falls '''glPushName''' oder '''glPopName''' zwischen [[glBegin]] und dem zugehörigen Aufruf von [[glEnd]] aufgerufen werden. | ||
| + | |||
| + | |||
| + | |||
| + | ==Zugehörige Wertrückgaben== | ||
| + | *[[glGet]] mit dem Argument [[glGet#GL_NAME_STACK_DEPTH|GL_NAME_STACK_DEPTH]] | ||
| + | *[[glGet]] mit dem Argument [[glGet#GL_MAX_NAME_STACK_DEPTH|GL_MAX_NAME_STACK_DEPTH]] | ||
| + | |||
| + | |||
| + | |||
| + | ==Siehe auch== | ||
[[glInitNames]], [[glLoadName]], [[glRenderMode]], [[glSelectBuffer]] | [[glInitNames]], [[glLoadName]], [[glRenderMode]], [[glSelectBuffer]] | ||
[[Kategorie:GL|PushName]] | [[Kategorie:GL|PushName]] | ||
| + | [[Kategorie:GL1.0|PushName]] | ||
Aktuelle Version vom 29. Juli 2011, 09:40 Uhr
Inhaltsverzeichnis
glPushName, glPopName
Name
glPushName, glPopName - setzt bzw. nimmt einen Eintrag vom Namenstack.
Delphi-Spezifikation
procedure glPushName(name: GLuint); procedure glPopName();
Parameter
| name | Der Eintrag, der auf dem Namenstack hinzugefügt werden soll. |
|---|
Beschreibung
Unter einem Namen sollte man in diesem Fall nicht an einen String denken, sondern an eine Zahl in Form einer ID. Der Namenstack wird während des Selektions-Modus benutzt, um eine eindeutige Identifizierung von Render-Anweisungen zu ermöglichen. Der Namestack besteht aus vorzeichenlosen Integern und ist zu Beginn leer.
glPushName fügt einen neuen Namen dem Stack hinzu, während glPopName den obersten Eintrag vom Stack entfernt.
Die maximale Größe des Namenstack hängt von der Implementierung ab. Um herauszufinden, welche Größe auf dem System maximal unterstützt wird, kann man glGet mit dem Parameter GL_MAX_NAME_STACK_DEPTH aufrufen. Es wird als Fehler angesehen, wenn ein Name zu einem vollen Stack hinzugefügt wird oder es versucht wird, einen Eintrag aus einem leeren Stack zu entfernen. Ebenfalls wird es als Fehler angesehen, den Namestack während eines Aufrufes von glBegin und dem dazugehörigen glEnd zu manipulieren. In allen diesen Fällen wird das Error Flag gesetzt und keine weiteren Veränderungen durchgeführt.
Der Namenstack ist immer leer, wenn der Rendermodus nicht GL_SELECT entspricht. Aufrufe von glPushName oder glPopName werden werden ebenfalls ignoriert, sollte der Rendermodus nicht auf GL_SELECT gesetzt sein.
Fehlermeldungen
GL_STACK_OVERFLOW wird generiert, falls glPushName aufgerufen wird, während der Namenstack voll ist.
GL_STACK_UNDERFLOW wird generiert, wenn glPopName aufgerufen wird, während der Namenstack leer ist.
GL_INVALID_OPERATION wird generiert, falls glPushName oder glPopName zwischen glBegin und dem zugehörigen Aufruf von glEnd aufgerufen werden.
Zugehörige Wertrückgaben
- glGet mit dem Argument GL_NAME_STACK_DEPTH
- glGet mit dem Argument GL_MAX_NAME_STACK_DEPTH
