GLAPI/glGenQueries

From OpenGL.org
Jump to: navigation, search
glGenQueries
Core in version 4.4
Core since version 1.5

glGenQueries: generate query object names

Function Definition

 void glGenQueries(GLsizei n​, GLuint * ids​);
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.

Errors

GL_INVALID_VALUE​ is generated if n​ is negative.

Associated Gets

glIsQuery

See Also

glBeginQuery, glEndQuery, glGetQuery, glDeleteQueries, glIsQuery

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