glGenQueries

From OpenGL Reference
Jump to navigation Jump to search

Generate query object names.

C Specification[edit]

void glGenQueries( GLsizei n, GLuint * ids );


Parameters[edit]

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[edit]

 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 .


Errors[edit]

 GL_INVALID_VALUE is generated if n is negative.


Associated Gets[edit]

 glIsQuery 


Version Support[edit]

 glGenQueries  2.0+

See Also[edit]

 glBeginQuery , glDeleteQueries , glEndQuery 


Copyright[edit]

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/.