GLAPI/glDeleteTextures: Difference between revisions
m Renaming category: 'GL 4 API Texturing' to 'Core API Ref Texturing'. |
m Bot: Adding better formatting. |
||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glDeleteTextures'''(GLsizei | void '''glDeleteTextures'''(GLsizei {{param|n}}, const GLuint * {{param|textures}}); | ||
; n | ; n | ||
| Line 17: | Line 17: | ||
== Description == | == Description == | ||
'''glDeleteTextures''' deletes | '''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 | {{code|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glIsTexture}} | |||
== See Also == | == See Also == | ||
{{apifunc|glBindTexture}}, {{apifunc|glCopyTexImage1D}}, {{apifunc|glCopyTexImage2D}}, {{apifunc|glGenTextures}}, {{apifunc|glGet}}, {{apifunc|glGetTexParameter}}, {{apifunc|glTexImage1D}}, {{apifunc|glTexImage2D}}, {{apifunc|glTexParameter}} | |||
== Copyright == | == Copyright == | ||
Revision as of 01:16, 29 April 2012
| 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
See Also
glBindTexture, glCopyTexImage1D, glCopyTexImage2D, glGenTextures, glGet, glGetTexParameter, glTexImage1D, glTexImage2D, glTexParameter
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/.