glCallList-Funktion

Die glCallList-Funktion führt eine Anzeigeliste aus.

Syntax

void WINAPI glCallList(
   GLuint list
);

Parameter

list

Der ganzzahlige Name der auszuführenden Anzeigeliste.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Durch aufrufen der glCallList-Funktion wird die Ausführung der benannten Anzeigeliste gestartet. Die in der Anzeigeliste gespeicherten Funktionen werden in der Reihenfolge ausgeführt, so als ob Sie sie aufgerufen haben, ohne eine Anzeigeliste zu verwenden. Wenn die Liste nicht als Anzeigeliste definiert wurde, wird glCallList ignoriert.

Die glCallList-Funktion kann in einer Anzeigeliste angezeigt werden. Um die Möglichkeit einer unendlichen Rekursion zu vermeiden, die sich aus dem Aufrufen von Anzeigelisten ergibt, wird während der Ausführung der Anzeigeliste eine Beschränkung auf die Schachtelungsebene von Anzeigelisten gesetzt. Dieser Grenzwert beträgt mindestens 64, hängt jedoch von der Implementierung ab.

Der OpenGL-Zustand wird nicht gespeichert und über einen Aufruf von glCallList wiederhergestellt. Änderungen, die während der Ausführung einer Anzeigeliste am OpenGL-Zustand vorgenommen wurden, bleiben daher nach Abschluss der Ausführung der Anzeigeliste erhalten. Verwenden Sie glPushAttrib, glPopAttrib, glPopAttrib, glPushMatrix und glPopMatrix, um den OpenGL-Zustand über glCallList-Aufrufe hinweg beizubehalten.

Sie können Anzeigelisten zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd ausführen, sofern die Anzeigeliste nur Funktionen enthält, die in diesem Intervall zulässig sind.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glCallList ab:

glGet mit argument GL_MAX_LIST_NESTING

glIsList

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

glCallLists

glDeleteLists

glEnd

glGenLists

glGet

glIsList

glNewList

glPopAttrib

glPopMatrix

glPushAttrib

glPushMatrix