OpenGL Error Codes: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
Zyx 2000 (talk | contribs)
No edit summary
Zyx 2000 (talk | contribs)
(No difference)

Revision as of 15:05, 17 May 2011

In OpenGL, the function glGetError() tells you if an error has occurred in a program; for example, if you pass an invalid value to a function. When an error occurs, an error code is saved by the implementation. This error code will be the return value of glGetError() next time it is called.

Error Codes returned by glGetError():

Error Code Description
GL_INVALID_ENUM Given when an enumeration parameter contains an enum that is not allowed for that function
GL_INVALID_VALUE Given when a numerical parameter does not conform to the range requirements that the function places upon it
GL_INVALID_OPERATION Given when the function in question cannot be executed because of state that has been set in the context
GL_OUT_OF_MEMORY Given when performing an operation that can allocate memory, when the memory in question cannot be allocated
GL_INVALID_FRAMEBUFFER_OPERATION (See note below)
GL_STACK_OVERFLOW* Given when a stack pushing operation causes a stack to overflow the limit of that stack's size.
GL_STACK_UNDERFLOW* Given when a stack popping operation is given when the stack is already at its lowest point.
GL_TABLE_TOO_LARGE This error code is a part of the GL_ARB_imaging extention

Error codes marked with an asterisk are deprecated and can only be returned when using deprecated functionality.

Framebuffer Objects have their own error codes for codes for testing framebuffer completeness. The meaning of these codes is defined in the section on framebuffer completeness.