table of contents
GLGETQUERYOBJECT(3G) | [FIXME: manual] | GLGETQUERYOBJECT(3G) |
NAME¶
glGetQueryObject - return parameters of a query object
C SPECIFICATION¶
void glGetQueryObjectiv(GLuint id, GLenum pname, GLint * params);
void glGetQueryObjectuiv(GLuint id, GLenum pname, GLuint * params);
void glGetQueryObjecti64v(GLuint id, GLenum pname, GLint64 * params);
void glGetQueryObjectui64v(GLuint id, GLenum pname, GLuint64 * params);
PARAMETERS¶
id
pname
params
DESCRIPTION¶
glGetQueryObject returns in params a selected parameter of the query object specified by id.
pname names a specific query object parameter. pname can be as follows:
GL_QUERY_RESULT
GL_QUERY_RESULT_NO_WAIT
GL_QUERY_RESULT_AVAILABLE
NOTES¶
If an error is generated, no change is made to the contents of params.
glGetQueryObject implicitly flushes the GL pipeline so that any incomplete rendering delimited by the occlusion query completes in finite time.
If multiple queries are issued using the same query object id before calling glGetQueryObject, the results of the most recent query will be returned. In this case, when issuing a new query, the results of the previous query are discarded.
glGetQueryObjecti64v and glGetQueryObjectui64v are available only if the GL version is 3.3 or greater.
GL_QUERY_RESULT_NO_WAIT is accepted for pname only if the GL version is 4.4 or greater.
The GL_QUERY_RESULT_BUFFER target is available only if the GL version is 4.4 or higher. On earlier versions of the GL, params is always an address in client memory.
ERRORS¶
GL_INVALID_ENUM is generated if pname is not an accepted value.
GL_INVALID_OPERATION is generated if id is not the name of a query object.
GL_INVALID_OPERATION is generated if id is the name of a currently active query object.
GL_INVALID_OPERATION is generated if a buffer is currently bound to the GL_QUERY_RESULT_BUFFER target and the command would cause data to be written beyond the bounds of that buffer's data store.
VERSION SUPPORT¶
OpenGL Version | ||||||||||||
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5 |
glGetQueryObjecti64v | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
glGetQueryObjectiv | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
glGetQueryObjectui64v | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
glGetQueryObjectuiv | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
SEE ALSO¶
glBeginQuery(),
glEndQuery, glGetQueryiv(), glIsQuery(), glQueryCounter()
COPYRIGHT¶
Copyright © 2005 Addison-Wesley. Copyright © 2010-2014 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. http://opencontent.org/openpub/.
COPYRIGHT¶
Copyright © 2005 Sams Publishing
Copyright © 2010-2014 Khronos Group
11/18/2024 | [FIXME: source] |