GLAPI/glDeleteQueries: Difference between revisions
m Bot: Adding better formatting. |
m Bot: Adding better formatting. |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 19: | Line 19: | ||
'''glDeleteQueries''' deletes {{param|n}} query objects named by the elements of the array {{param|ids}}. After a query object is deleted, it has no contents, and its name is free for reuse (for example by {{apifunc|glGenQueries}}). | '''glDeleteQueries''' deletes {{param|n}} query objects named by the elements of the array {{param|ids}}. After a query object is deleted, it has no contents, and its name is free for reuse (for example by {{apifunc|glGenQueries}}). | ||
'''glDeleteQueries''' silently ignores 0's and names that do not correspond to existing query objects. | '''glDeleteQueries''' silently ignores 0's and names that do not correspond to existing query objects. If one of the query objects to be deleted is currently active, the name becomes unused, but the underlying query object is not deleted until it is no longer active. | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== Associated Gets == | == Associated Gets == | ||
| Line 31: | Line 31: | ||
== See Also == | == See Also == | ||
{{apifunc| | {{apifunc|glGenQueries}}, {{apifunc|glBeginQuery}}, {{apifunc|glEndQuery}}, {{apifunc|glGetQueryiv}}, {{apifunc|glIsQuery}} | ||
== Copyright == | == Copyright == | ||
Latest revision as of 01:42, 27 September 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 1.5 | |
glDeleteQueries: delete named query objects
Function Definition
void glDeleteQueries(GLsizei n, const GLuint * ids);
- n
- Specifies the number of query objects to be deleted.
- ids
- Specifies an array of query objects to be deleted.
Description
glDeleteQueries deletes n query objects named by the elements of the array ids. After a query object is deleted, it has no contents, and its name is free for reuse (for example by glGenQueries).
glDeleteQueries silently ignores 0's and names that do not correspond to existing query objects. If one of the query objects to be deleted is currently active, the name becomes unused, but the underlying query object is not deleted until it is no longer active.
Errors
GL_INVALID_VALUE is generated if n is negative.
Associated Gets
See Also
glGenQueries, glBeginQuery, glEndQuery, glGetQueryiv, 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/.