Revision as of 21:42, 26 September 2012 by AlfonsesCategoryBot (talk | contribs) (Bot: Adding better formatting.)

Jump to: navigation, search
Core in version 4.5
Core since version 4.3
Core ARB extension KHR_debug

glDebugMessageInsert: inject an application-supplied message into the debug message queue

Function Definition

 void glDebugMessageInsert(GLenum source​, GLenum type​, GLuint id​, GLenum severity​, GLsizei length​, const char *message​);
The source of the debug message to insert.
The type of the debug message insert.
The user-supplied identifier of the message to insert.
The severity of the debug messages to insert.
The length string contained in the character array whose address is given by message​.
The address of a character array containing the message to insert.


glDebugMessageInsert inserts a user-supplied message into the debug output queue. source​ specifies the source that will be used to classify the message and must be GL_DEBUG_SOURCE_APPLICATION or GL_DEBUG_SOURCE_THIRD_PARTY. All other sources are reserved for use by the GL implementation. type​ indicates the type of the message to be inserted and may be one of GL_DEBUG_TYPE_ERROR, GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR, GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR, GL_DEBUG_TYPE_PORTABILITY, GL_DEBUG_TYPE_PERFORMANCE, or GL_DEBUG_TYPE_OTHER. severity​ indicates the severity of the message and may be GL_DEBUG_SEVERITY_LOW, GL_DEBUG_SEVERITY_MEDIUM, or GL_DEBUG_SEVERITY_HIGH. id​ is available for application defined use and may be any value. This value will be recorded and used to identify the message.

length​ contains a count of the characters in the character array whose address is given in message​. If length​ is negative then message​ is treated as a null-terminated string. The length of the message, whether specified explicitly or implicitly, must be less than or equal to the implementation defined constant GL_MAX_DEBUG_MESSAGE_LENGTH.


GL_INVALID_ENUM is generated if any of source​, type​ or severity​ is not one of the accepted interface types.

GL_INVALID_VALUE is generated if the length of the message is greater than the value of GL_MAX_DEBUG_MESSAGE_LENGTH.

See Also

glDebugMessageControl, glDebugMessageCallback, glGetDebugMessageLog, glPushDebugGroup, glPopDebugGroup


Copyright © 2012 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999.