funzione glNewList
Le funzioni glNewList e glEndList creano o sostituiscono un elenco di visualizzazione.
void WINAPI glNewList(
GLuint list,
GLenum mode
);
-
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.
Questa funzione non restituisce un valore.
I codici di errore seguenti possono essere recuperati dalla funzione glGetError .
Nome | Significato |
---|---|
|
list era zero. |
|
la modalità non è stata accettata. |
|
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd. |
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
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
Libreria |
|
DLL |
|