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
GL_INVALID_VALUE	list era cero.
GL_INVALID_ENUM	mode no era un valor aceptado.
GL_INVALID_OPERATION	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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glCallList

glCallLists

glDeleteLists

glEnd

glEndList

glGenLists

glIsList