Difference between revisions of "GLAPI/glDeleteBuffers"

From OpenGL Wiki
Jump to navigation Jump to search
(→‎Description: Deletion correction.)
 
(One intermediate revision by one other user not shown)
Line 17: Line 17:
 
== Description ==
 
== Description ==
  
'''glDeleteBuffers''' deletes {{param|n}} buffer objects named by the elements of the array {{param|buffers}}. After a buffer object is deleted, it has no contents, and its name is free for reuse by {{apifunc|glGenBuffers}}.
+
'''glDeleteBuffers''' deletes {{param|n}} buffer objects named by the elements of the array {{param|buffers}}. After a buffer object is deleted, it has no contents, and its name is free for reuse (for example by {{apifunc|glGenBuffers}}). If a buffer object that is currently bound is deleted, the binding reverts to 0 (the absence of any buffer object).
  
 
'''glDeleteBuffers''' silently ignores 0's and names that do not correspond to existing buffer objects.
 
'''glDeleteBuffers''' silently ignores 0's and names that do not correspond to existing buffer objects.
 +
 +
If any portion of a buffer object being deleted is mapped in the current context or any context current to another thread, it is as though {{apifunc|glUnmapBuffer}} is executed in each such context prior to deleting the data store of the buffer.
  
 
== Errors ==
 
== Errors ==

Latest revision as of 15:27, 29 April 2020

glDeleteBuffers
Core in version 4.6
Core since version 1.5

glDeleteBuffers: delete named buffer objects

Function Definition

 void glDeleteBuffers(GLsizei n​, const GLuint * buffers​);
n
Specifies the number of buffer objects to be deleted.
buffers
Specifies an array of buffer objects to be deleted.

Description

glDeleteBuffers deletes n​ buffer objects named by the elements of the array buffers​. After a buffer object is deleted, it has no contents, and its name is free for reuse (for example by glGenBuffers). If a buffer object that is currently bound is deleted, the binding reverts to 0 (the absence of any buffer object).

glDeleteBuffers silently ignores 0's and names that do not correspond to existing buffer objects.

If any portion of a buffer object being deleted is mapped in the current context or any context current to another thread, it is as though glUnmapBuffer is executed in each such context prior to deleting the data store of the buffer.

Errors

GL_INVALID_VALUE is generated if n​ is negative.

Associated Gets

glIsBuffer

See Also

glBindBuffer, glGenBuffers, glIsBuffer

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