Difference between revisions of "GLAPI/glDeleteQueries"

From OpenGL.org
Jump to: navigation, search
m (Renaming category: 'API Reference 4' to 'Core API Reference'.)
m (Bot: Adding better formatting.)
 
(3 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
== Function Definition ==
 
== Function Definition ==
  
   void '''glDeleteQueries'''(GLsizei ''n'', const GLuint * ''ids'');
+
   void '''glDeleteQueries'''(GLsizei {{param|n}}, const GLuint * {{param|ids}});
  
 
; n
 
; n
Line 17: Line 17:
 
== Description ==
 
== 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 [[GLAPI/glGenQueries|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 ==
  
{{code|GL_INVALID_VALUE}} is generated if ''n'' is negative.
+
{{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.
  
 
== Associated Gets ==
 
== Associated Gets ==
  
[[GLAPI/glIsQuery|glIsQuery]]
+
{{apifunc|glIsQuery}}
  
 
== See Also ==
 
== See Also ==
  
[[GLAPI/glBeginQuery|glBeginQuery]], [[GLAPI/glEndQuery|glEndQuery]], [[GLAPI/glGenQueries|glGenQueries]], [[GLAPI/glGetQueryiv|glGetQueryiv]], [[GLAPI/glGetQueryObject|glGetQueryObject]]
+
{{apifunc|glGenQueries}}, {{apifunc|glBeginQuery}}, {{apifunc|glEndQuery}}, {{apifunc|glGetQueryiv}}, {{apifunc|glIsQuery}}
  
 
== Copyright ==
 
== Copyright ==

Latest revision as of 21:42, 26 September 2012

glDeleteQueries
Core in version 4.5
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

glIsQuery

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