glLoadName: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
()
K (Kategorisierung)
 
(17 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= glLoadName =
 
= glLoadName =
  
<br>
+
 
== glLoadName ==
+
 
----
+
== Name ==
'''glLoadName''' - lädt einen Namen auf den Namestack.
+
'''glLoadName''' - lädt einen [[OpenGL Name]]n auf den [[Stack|Namestack]].
<br>
+
 
 +
 
 +
 
 
== Delphi-Spezifikation ==
 
== Delphi-Spezifikation ==
----
+
'''procedure''' glLoadName(''name'' : GLuint);
'''procedure''' glLoadName(''name'' : GLuint);
+
 
 +
 
  
<br>
 
 
== Parameter ==
 
== Parameter ==
----
+
{|border=1 rules=all
<table border=1 rules=all>
+
!''name''
<tr>
+
|Stellt den Namen dar, der auf den Stack gelegt werden soll.
<td>''name''</td>
+
|}
<td>Stellt den Namen dar, der auf den Stack gelegt werden soll.</td>
+
 
</tr>
+
 
</table>
 
  
<br>
 
 
== Beschreibung ==  
 
== Beschreibung ==  
----
+
Der Namestack wird im [[Selection]]mode 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 ersetzt das oberste Element des Stacks (der nach der Initialisierung leer ist). Die Funktion ist das Gegenstück zu [[glLoadMatrix|glLoadMatrix]], aber mit dem Unterschied, dass der Matrixstack niemals leer ist. Daher schlägt diese Funktion auch fehl, wenn man vorher nicht mindestens einmal [[glPushName|glPushName]] aufgerufen hat.
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). <br>
+
 
  
(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.)
 
  
<br>
 
 
== Hinweise ==
 
== Hinweise ==
----
+
Solange der Rendermodus nicht '''GL_SELECT''' ist, ist der Namestack leer.
Solange der Rendermodus nicht '''GL_SELECT''' ist, ist der Namestack leer.<br>
+
 
Aufrufe von '''glLoadName''' werden ignoriert wenn der Rendermodus nich '''GL_SELECT''' ist.
+
Aufrufe von '''glLoadName''' werden ignoriert, wenn der Rendermodus nicht '''GL_SELECT''' ist.
 +
 
 +
 
 +
 
  
  
<br>
 
 
== Fehlermeldungen ==
 
== Fehlermeldungen ==
----
+
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glLoadName''' bei leerem Namestack aufgerufen wird.
GL_FEHLER wird generiert wenn '''glLoadName''' bei leerem Namestack aufgerufen wird. <br>
+
 
GL_INVALID_OPERATION wird generiert wenn '''glLoadName''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
+
'''GL_INVALID_OPERATION''' wird generiert, wenn '''glLoadName''' innerhalb eines [[glBegin]]-[[glEnd]]-Blocks aufgerufen wird.
 +
 
 +
 
 +
 
  
<br>
 
 
==  Zugehörige Wertrückgaben ==
 
==  Zugehörige Wertrückgaben ==
----
+
[[glGet]] mit Token [[glGet#GL_NAME_STACK_DEPTH|GL_NAME_STACK_DEPTH]]
[[glGet]] mit Token GL_NAME_STACK_DEPTH <br>
+
 
[[glGet]] mit Token GL_MAX_NAME_STACK_DEPTH
+
[[glGet]] mit Token [[glGet#GL_MAX_NAME_STACK_DEPTH|GL_MAX_NAME_STACK_DEPTH]]
 +
 
 +
 
  
<br>
 
 
== Siehe auch ==
 
== Siehe auch ==
----
 
 
[[glInitNames]], [[glPushName]], [[glRenderMode]], [[glSelectBuffer]]
 
[[glInitNames]], [[glPushName]], [[glRenderMode]], [[glSelectBuffer]]
 +
 +
Hintergrundwissen: [[OpenGL Name]]
 +
 +
[[Kategorie:GL|LoadName]]
 +
[[Kategorie:GL1.0|LoadName]]

Aktuelle Version vom 25. Juli 2011, 11:46 Uhr

glLoadName

Name

glLoadName - lädt einen OpenGL 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 ersetzt das oberste Element des Stacks (der nach der Initialisierung leer ist). Die Funktion ist das Gegenstück zu glLoadMatrix, aber mit dem Unterschied, dass der Matrixstack niemals leer ist. Daher schlägt diese Funktion auch fehl, wenn man vorher nicht mindestens einmal glPushName aufgerufen hat.


Hinweise

Solange der Rendermodus nicht GL_SELECT ist, ist der Namestack leer.

Aufrufe von glLoadName werden ignoriert, wenn der Rendermodus nicht GL_SELECT ist.



Fehlermeldungen

GL_INVALID_OPERATION 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

Hintergrundwissen: OpenGL Name