GLAPI/glDeleteTextures: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Renaming category: 'GL 4 API Texturing' to 'Core API Ref Texturing'.
 
(4 intermediate revisions by one other user not shown)
Line 8: Line 8:
== Function Definition ==
== Function Definition ==


   void '''glDeleteTextures'''(GLsizei ''n'', const GLuint * ''textures'');
   void '''glDeleteTextures'''(GLsizei {{param|n}}, const GLuint * {{param|textures}});


; n
; n
Line 17: Line 17:
== Description ==
== Description ==


'''glDeleteTextures''' deletes ''n'' textures named by the elements of the array ''textures''. After a texture is deleted, it has no contents or dimensionality, and its name is free for reuse (for example by [[GLAPI/glGenTextures|glGenTextures]]). If a texture that is currently bound is deleted, the binding reverts to 0 (the default texture).
'''glDeleteTextures''' deletes {{param|n}} textures named by the elements of the array {{param|textures}}. After a texture is deleted, it has no contents or dimensionality, and its name is free for reuse (for example by {{apifunc|glGenTextures}}). If a texture that is currently bound is deleted, the binding reverts to 0 (the default texture).


'''glDeleteTextures''' silently ignores 0's and names that do not correspond to existing textures.
'''glDeleteTextures''' silently ignores 0's and names that do not correspond to existing textures.
Line 23: Line 23:
== 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/glIsTexture|glIsTexture]]
{{apifunc|glIsTexture}}


== See Also ==
== See Also ==


[[GLAPI/glBindTexture|glBindTexture]], [[GLAPI/glCopyTexImage1D|glCopyTexImage1D]], [[GLAPI/glCopyTexImage2D|glCopyTexImage2D]], [[GLAPI/glGenTextures|glGenTextures]], [[GLAPI/glGet|glGet]], [[GLAPI/glGetTexParameter|glGetTexParameter]], [[GLAPI/glTexImage1D|glTexImage1D]], [[GLAPI/glTexImage2D|glTexImage2D]], [[GLAPI/glTexParameter|glTexParameter]]
{{apifunc|glBindTexture}}, {{apifunc|glGenTextures}}, {{apifunc|glIsTexture}}


== Copyright ==
== Copyright ==


Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [http://oss.sgi.com/projects/FreeB/ http://oss.sgi.com/projects/FreeB/].
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt LicenseRef-FreeB].


[[Category:Core API Reference|DeleteTextures]]
[[Category:Core API Reference|DeleteTextures]]
[[Category:Core API Ref Texturing|DeleteTextures]]
[[Category:Core API Ref Texturing|DeleteTextures]]
[[Category:Texture Object API State Functions|DeleteTextures]]

Latest revision as of 22:01, 5 February 2021

glDeleteTextures
Core in version 4.6
Core since version 1.1

glDeleteTextures: delete named textures

Function Definition

 void glDeleteTextures(GLsizei n​, const GLuint * textures​);
n
Specifies the number of textures to be deleted.
textures
Specifies an array of textures to be deleted.

Description

glDeleteTextures deletes n​ textures named by the elements of the array textures​. After a texture is deleted, it has no contents or dimensionality, and its name is free for reuse (for example by glGenTextures). If a texture that is currently bound is deleted, the binding reverts to 0 (the default texture).

glDeleteTextures silently ignores 0's and names that do not correspond to existing textures.

Errors

GL_INVALID_VALUE is generated if n​ is negative.

Associated Gets

glIsTexture

See Also

glBindTexture, glGenTextures, glIsTexture

Copyright

Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see LicenseRef-FreeB.