funzione glEndList

Le funzioni glNewList e glEndList creano o sostituiscono un elenco di visualizzazione.

Sintassi

void WINAPI glEndList(void);

Parametri

Questa funzione non ha parametri.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

Il codice di errore seguente può essere recuperato dalla funzione glGetError .

Nome	Significato
GL_INVALID_OPERATION	glEndList è stato chiamato senza un glNewList precedente o se glnewlist è stato chiamato mentre è stato definito un elenco di visualizzazione.

Commenti

Gli elenchi di visualizzazione sono gruppi di comandi OpenGL archiviati per l'esecuzione successiva. Gli elenchi di visualizzazione vengono creati con glNewList. Tutti i comandi successivi vengono inseriti nell'elenco di visualizzazione, nell'ordine emesso, fino a quando glEndList non viene chiamato.

La funzione glNewList ha due parametri. Il primo parametro, elenco, è un intero positivo che diventa il nome univoco per l'elenco di visualizzazione. I nomi possono essere creati e riservati con glGenLists e testati per l'univocità con glIsList. Il secondo parametro, la modalità, è una costante simbolica che può assumere uno dei due valori precedenti.

Alcuni comandi non vengono compilati nell'elenco di visualizzazione, ma vengono eseguiti immediatamente, indipendentemente dalla modalità elenco di visualizzazione. Questi comandi sono glColorPointer, glDeleteLists, glDisableClientState, glEdgeFlagPointer, glEnableClientState, glFeedbackBuffer, glFinish, glFlush, glGenLists, glIndexPointer, glInterleavedArrays, glIsEnabled, glIsList, glNormalPointer, glPopClientAttrib, glPixelStore, glPushClientAttrib, glPushClientAttrib, glReadPixels, glRenderMode, glSelectBuffer, glTexCoordPointer, glVertexPointer e tutte le routine glGet.

Analogamente, glTexImage2D e glTexImage1D vengono eseguiti immediatamente e non compilati nell'elenco di visualizzazione quando il primo argomento è GL_PROXY_TEXTURE_2D o GL_PROXY_TEXTURE_1D rispettivamente.

Quando viene rilevata la funzione glEndList , la definizione dell'elenco visualizzato viene completata associando l'elenco con il nome univoco (specificato nel comando glNewList ). Se esiste già un elenco di nomi con un elenco di nomi, viene sostituito solo quando viene chiamato glEndList .

Le funzioni glCallList e glCallLists possono essere immesse negli elenchi di visualizzazione. I comandi nell'elenco visualizzato o negli elenchi eseguiti da glCallList o glCallLists non sono inclusi nell'elenco visualizzato creato, anche se la modalità di creazione dell'elenco è GL_COMPILE_AND_EXECUTE.

La funzione seguente recupera informazioni correlate a glNewList:

glGet con argomento GL_MATRIX_MODE

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glGenLists

glIsList

glNewList