glNewList-Funktion
Die Funktionen glNewList und glEndList erstellen oder ersetzen eine Anzeigeliste.
Syntax
void WINAPI glNewList(
GLuint list,
GLenum mode
);
Parameter
-
list
-
Der Name der Anzeigeliste.
-
mode
-
Der Kompilierungsmodus. Die folgenden Werte werden akzeptiert.
Wert Bedeutung - GL _ COMPILE
Befehle werden lediglich kompiliert. - GL _ COMPILE _ AND _ EXECUTE
Befehle werden ausgeführt, während sie in die Anzeigeliste kompiliert werden.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
list war 0 (null). |
|
mode war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen. |
Bemerkungen
Anzeigelisten sind Gruppen von OpenGL-Befehlen, die für die nachfolgende Ausführung gespeichert wurden. Die Anzeigelisten werden mit glNewList erstellt. Alle nachfolgenden Befehle werden in der Anzeigeliste in der reihenfolge platziert, in der sie ausgegeben werden, bis glEndList aufgerufen wird.
Die glNewList-Funktion verfügt über zwei Parameter. Der erste Parameter, list, ist eine positive ganze Zahl, die zum eindeutigen Namen für die Anzeigeliste wird. Namen können mit glGenLists erstellt und reserviert und mit glIsListauf Eindeutigkeit getestet werden. Der zweite Parameter, Mode, ist eine symbolische Konstante, die einen der beiden vorangehenden Werte annehmen kann.
Bestimmte Befehle werden nicht in die Anzeigeliste kompiliert, sondern unabhängig vom Anzeigelistenmodus sofort ausgeführt. Diese Befehle sind glColorPointer, glDeleteLists, glDisableClientState, glEdgeFlagPointer, glEnableClientState, glFeedbackBuffer, glFinish, glFlush, glGenLists, glIndexPointer, glInterleavedArrays, glIsEnabled, glIsList, glNormalPointer, glPopClientAttrib, glPixelStore, glPushClientAttrib, glReadPixels, glRenderMode, glSelectBuffer, glTexCoordPointer, glVertexPointerund alle glGet-Routinen.
Ebenso werden glTexImage2D und glTexImage1D sofort ausgeführt und nicht in die Anzeigeliste kompiliert, wenn das erste Argument GL _ PROXY TEXTURE _ _ 2D bzw. GL _ PROXY TEXTURE _ _ 1D ist.
Wenn die glEndList-Funktion gefunden wird, wird die Definition der Anzeigeliste abgeschlossen, indem die Liste der eindeutigen Namensliste zugeordnet wird (angegeben im Befehl glNewList). Wenn bereits eine Anzeigeliste mit namensliste vorhanden ist, wird sie nur ersetzt, wenn glEndList aufgerufen wird.
Die Funktionen glCallList und glCallLists können in Anzeigelisten eingegeben werden. Die Befehle in der Anzeigeliste oder in den Listen, die von glCallList oder glCallLists ausgeführt werden, sind nicht in der anzeigeliste enthalten, die erstellt wird, auch wenn der Listenerstellungsmodus GL _ COMPILE AND EXECUTE _ _ lautet.
Die folgende Funktion ruft Informationen im Zusammenhang mit glNewList ab:
glGet mit argument GL _ MATRIX _ MODE
Requirements (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 |
|