Función glGetError

La función glGetError devuelve información de error.

Sintaxis

GLenum WINAPI glGetError(void);

Parámetros

Esta función no tiene parámetros.

Valor devuelto

La función glGetError devuelve uno de los siguientes códigos de error.

Código devuelto	Descripción
GL_INVALID_ENUM	Se especifica un valor inaceptable para un argumento enumerado. La función incorrecta se omite, sin tener ningún efecto secundario distinto de establecer la marca de error.
GL_INVALID_VALUE	Un argumento numérico está fuera del intervalo. La función incorrecta se omite, sin tener ningún efecto secundario distinto de establecer la marca de error.
GL_INVALID_OPERATION	No se permite la operación especificada en el estado actual. La función incorrecta se omite, sin tener ningún efecto secundario distinto de establecer la marca de error.
GL_NO_ERROR	No se ha registrado ningún error. Se garantiza que el valor de esta constante simbólica es cero.
GL_STACK_OVERFLOW	Esta función provocaría un desbordamiento de pila. La función incorrecta se omite, sin tener ningún efecto secundario distinto de establecer la marca de error.
GL_STACK_UNDERFLOW	Esta función provocaría una subflujo de pila. La función incorrecta se omite, sin tener ningún efecto secundario distinto de establecer la marca de error.
GL_OUT_OF_MEMORY	No queda suficiente memoria para ejecutar la función. El estado de OpenGL no está definido, excepto el estado de las marcas de error, después de registrar este error.

Tenga en cuenta que glGetError devuelve GL_INVALID_OPERATION si se llama entre una llamada a glBegin y su llamada correspondiente a glEnd.

Comentarios

A cada error detectable se le asigna un código numérico y un nombre simbólico. Cuando se produce un error, la marca de error se establece en el valor de código de error adecuado. No se registran otros errores hasta que se llama a glGetError , se devuelve el código de error y la marca se restablece a GL_NO_ERROR. Si una llamada a glGetError devuelve GL_NO_ERROR, no se ha detectado ningún error detectable desde la última llamada a glGetError o desde que se inicializó OpenGL.

Para permitir implementaciones distribuidas, puede haber varias marcas de error. Si alguna marca de error única ha registrado un error, se devuelve el valor de esa marca y esa marca se restablece a GL_NO_ERROR cuando se llama a glGetError . Si más de una marca ha registrado un error, glGetError devuelve y borra un valor arbitrario de marca de error. Si se van a restablecer todas las marcas de error, siempre debe llamar a glGetError en un bucle hasta que devuelva GL_NO_ERROR.

Inicialmente, todas las marcas de error se establecen en GL_NO_ERROR.

Cuando se establece una marca de error, los resultados de una operación de OpenGL solo se definen si se ha producido GL_OUT_OF_MEMORY. En todos los demás casos, la función que genera el error se omite y no tiene ningún efecto en el estado openGL o el contenido del búfer de fotogramas.

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

glEnd