GLAPI/glGenQueries: Difference between revisions
4.0 API. |
m Bot: Adding better formatting. |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glGenQueries'''(GLsizei | void '''glGenQueries'''(GLsizei {{param|n}}, GLuint * {{param|ids}}); | ||
; n | ; n | ||
| Line 17: | Line 17: | ||
== Description == | == Description == | ||
'''glGenQueries''' returns | '''glGenQueries''' returns {{param|n}} query object names in {{param|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 | Query object names returned by a call to '''glGenQueries''' are not returned by subsequent calls, unless they are first deleted with {{apifunc|glDeleteQueries}}. | ||
No query objects are associated with the returned query object names until they are first used by calling | No query objects are associated with the returned query object names until they are first used by calling {{apifunc|glBeginQuery}}. | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glIsQuery}} | |||
== See Also == | == See Also == | ||
{{apifunc|glBeginQuery}}, {{apifunc|glEndQuery}}, {{apifunc|glGetQuery}}, {{apifunc|glDeleteQueries}}, {{apifunc|glIsQuery}} | |||
== Copyright == | == Copyright == | ||
| Line 39: | Line 39: | ||
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/ http://opencontent.org/openpub/]. | 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/ http://opencontent.org/openpub/]. | ||
[[Category:API Reference | [[Category:Core API Ref Queries and Timers|GenQueries]] | ||
[[Category:Core API Reference|GenQueries]] | |||
Latest revision as of 01:46, 27 September 2012
| Core in version | 4.6 | |
|---|---|---|
| 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
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/.