glGetQueryiv — return parameters of a query object target
void glGetQueryiv( | GLenum | target, |
GLenum | pname, | |
GLint * | params) ; |
target
Specifies a query object target.
Must be GL_SAMPLES_PASSED
.
pname
Specifies the symbolic name of a query object target parameter.
Accepted values are GL_CURRENT_QUERY
or GL_QUERY_COUNTER_BITS
.
params
Returns the requested data.
glGetQueryiv
returns in params
a selected parameter of the query object target
specified by target
.
pname
names a specific query object target parameter. When target
is
GL_SAMPLES_PASSED
, pname
can be as follows:
GL_CURRENT_QUERY
params
returns the name of the currently active occlusion query object.
If no occlusion query is active, 0 is returned. The initial value is 0.
GL_QUERY_COUNTER_BITS
params
returns the number of bits in the query counter used to accumulate passing samples.
If the number of bits returned is 0, the implementation does not support a query counter, and the results
obtained from glGetQueryObject are useless.
If an error is generated,
no change is made to the contents of params
.
glGetQueryiv
is available only if the GL version is 1.5 or greater.
GL_INVALID_ENUM
is generated if target
or pname
is not an
accepted value.
GL_INVALID_OPERATION
is generated if glGetQueryiv
is executed between the execution of glBegin
and the corresponding execution of glEnd.
Copyright © 2005 Addison-Wesley. 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/.