funzione glNewList

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

Sintassi

void WINAPI glNewList(
   GLuint list,
   GLenum mode
);

Parametri

list

Nome elenco visualizzato.

mode

Modalità di compilazione. I valori seguenti vengono accettati.

Valore	Significato
GL_COMPILE	I comandi vengono semplicemente compilati.
GL_COMPILE_AND_EXECUTE	I comandi vengono eseguiti durante la compilazione nell'elenco di visualizzazione.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_VALUE	list era zero.
GL_INVALID_ENUM	la modalità non è stata accettata.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

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

glEndList

glGenLists

glIsList