GlNewList (función)
Las funciones glNewList y glEndList crean o reemplazan una lista para mostrar.
Sintaxis
void WINAPI glNewList(
GLuint list,
GLenum mode
);
Parámetros
-
list
-
Nombre de la lista para mostrar.
-
mode
-
Modo de compilación. Se aceptan los valores siguientes.
Value Significado - GL_COMPILE
Los comandos se compilan simplemente. - GL_COMPILE_AND_EXECUTE
Los comandos se ejecutan a medida que se compilan en la lista de visualización.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
list era cero. |
|
mode no era un valor aceptado. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
Las listas para mostrar son grupos de comandos openGL que se han almacenado para su posterior ejecución. Las listas de visualización se crean con glNewList. Todos los comandos posteriores se colocan en la lista de visualización, en el orden emitido, hasta que se llame a glEndList .
La función glNewList tiene dos parámetros. El primer parámetro, list, es un entero positivo que se convierte en el nombre único de la lista para mostrar. Los nombres se pueden crear y reservar con glGenLists y probarse para su unicidad con glIsList. El segundo parámetro, el modo, es una constante simbólica que puede asumir uno de los dos valores anteriores.
Algunos comandos no se compilan en la lista de visualización, pero se ejecutan inmediatamente, independientemente del modo de lista para mostrar. Estos comandos son glColorPointer, glDeleteLists, glDisableClientState, glEdgeFlagPointer, glEnableClientState, glFeedbackBuffer, glFinish, glFlush, glGenLists, glIndexPointer, glInterleavedArrays, glIsEnabled, glIsList, glNormalPointer, glPopClientAttrib, glPixelStore, glPushClientAttrib, glReadPixels, glRenderMode, glSelectBuffer, glTexCoordPointer, glVertexPointer y todas las rutinas glGet .
Del mismo modo, glTexImage2D y glTexImage1D se ejecutan inmediatamente y no se compilan en la lista de visualización cuando su primer argumento es GL_PROXY_TEXTURE_2D o GL_PROXY_TEXTURE_1D, respectivamente.
Cuando se encuentra la función glEndList , la definición de lista para mostrar se completa asociando la lista con la lista de nombres únicos (especificada en el comando glNewList ). Si ya existe una lista para mostrar con la lista de nombres, solo se reemplaza cuando se llama a glEndList .
Las funciones glCallList y glCallLists se pueden introducir en listas de visualización. Los comandos de la lista de visualización o listas ejecutadas por glCallList o glCallLists no se incluyen en la lista de visualización que se está creando, incluso si el modo de creación de listas es GL_COMPILE_AND_EXECUTE.
La siguiente función recupera información relacionada con glNewList:
glGet con GL_MATRIX_MODE de argumentos
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|