2005
Sams Publishing
glGenQueries
3G
glGenQueries
generate query object names
C Specification
void glGenQueries
GLsizei n
GLuint * ids
Parameters
n
Specifies the number of query object names to be generated.
ids
Specifies an array in which the generated query object names are stored.
Description
glGenQueries returns n query object names in ids.
There is no guarantee that the names form a contiguous set of integers;
however, it is guaranteed that none of the returned names was in use
immediately before the call to glGenQueries.
Query object names returned by a call to glGenQueries are not returned by
subsequent calls, unless they are first deleted with
glDeleteQueries.
No query objects are associated with the returned query object names until they are first used by calling
glBeginQuery.
Notes
glGenQueries is available only if the GL version is 1.5 or greater.
Errors
GL_INVALID_VALUE is generated if n is negative.
GL_INVALID_OPERATION is generated if glGenQueries is executed
between the execution of glBeginQuery and the corresponding
execution of glEndQuery.
GL_INVALID_OPERATION is generated if glGenQueries is executed
between the execution of glBegin and the corresponding
execution of glEnd.
Associated Gets
glIsQuery
See Also
glBeginQuery,
glDeleteQueries,
glEndQuery
Copyright
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/.