glLoadName-Funktion
Die glLoadName-Funktion lädt einen Namen in den Namensstapel.
Syntax
void WINAPI glLoadName(
GLuint name
);
Parameter
-
name
-
Ein Name, der den obersten Wert im Namensstapel ersetzt.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Funktion wurde aufgerufen, während der Namensstapel leer war. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glLoadName-Funktion bewirkt, dass name den Wert oben im Namensstapel ersetzt, der anfänglich leer ist. Der Namensstapel wird während des Auswahlmodus verwendet, um eine eindeutige Identifizierung von Renderingbefehlen zu ermöglichen. Sie besteht aus einem sortierten Satz von ganzen Zahlen ohne Vorzeichen.
Der Namensstapel ist immer leer, während der Rendermodus nicht GL_SELECT ist. Aufrufe von glLoadName , während der Rendermodus nicht GL_SELECT ist, werden ignoriert.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glLoadName ab:
glGet mit Argument GL_NAME_STACK_DEPTH
glGet mit Argument GL_MAX_NAME_STACK_DEPTH
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|