glEndList-Funktion

Die Funktionen glNewList und glEndList erstellen oder ersetzen eine Anzeigeliste.

Syntax

void WINAPI glEndList(void);

Parameter

Diese Funktion besitzt keine Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL_INVALID_OPERATION
glEndList wurde ohne vorherige glNewList aufgerufen, oder wenn glnewlist aufgerufen wurde, während eine Anzeigeliste definiert wurde.

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 ausgegebenen Reihenfolge in der Anzeigeliste platziert, 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 glIsList auf Eindeutigkeit getestet werden. Der zweite Parameter, mode, ist eine symbolische Konstante, die einen der beiden vorherigen Werte annehmen kann.

Bestimmte Befehle werden nicht in die Anzeigeliste kompiliert, sondern sofort ausgeführt, unabhängig vom Anzeigelistenmodus. Diese Befehle sind glColorPointer, glDeleteLists, glDisableClientState, glEdgeFlagPointer, glEnableClientState, glFeedbackBuffer, glFinish, glFlush, glGenLists, glIndexPointer, glInterleavedArrays, glIsEnabled, glIsList, glNormalPointer, glPopClientAttrib, glPixelStore, glPushClientAttrib, glPushClientAttrib, glReadPixels, glRenderMode, glSelectBuffer, glTexCoordPointer, glVertexPointer und 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 Anzeigelistendefinition abgeschlossen, indem die Liste der eindeutigen Namensliste zugeordnet wird (angegeben im GlNewList-Befehl ). 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 den von glCallList oder glCallLists ausgeführten Listen sind nicht in der anzeigeliste enthalten, die erstellt wird, auch wenn der Listenerstellungsmodus GL_COMPILE_AND_EXECUTE ist.

Die folgende Funktion ruft Informationen im Zusammenhang mit glNewList ab:

glGet mit Argument GL_MATRIX_MODE

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glGenLists

glIsList

glNewList