glDeleteTextures

[New - Windows 95, OEM Service Release 2]

The glDeleteTextures function deletes named textures.

void glDeleteTextures(

    GLsizei n,

 

    const GLuint * textures

 

   );

 

 

Parameters

n

The number of textures to be deleted.

textures

An array of textures to be deleted.

 

Remarks

The glDeleteTextures function 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). The glDeleteTextures function ignores zeros and names that do not correspond to existing textures.

If a texture that is currently bound is deleted, the binding reverts to zero (the default texture).

You cannot include calls to glDeleteTextures in display lists.

 

Note  The glDeleteTextures function is only available in OpenGL version 1.1 or later.

 

The following function retrieves information related to glDeleteTextures:

glIsTexture

 

Error Codes

The following are the error codes generated and their conditions.

Error Code

Condition

GL_INVALID_VALUE

n was a negative value.

GL_INVALID_OPERATION

glDeleteTextures was called between a call to glBegin and the corresponding call to glEnd.

 

See Also

glAreTexturesResident, glBegin, glBindTexture, glEnd, glGenTextures, glGet, glGetTexParameter, glIsTexture, glPrioritizeTextures, glTexGen, glTexImage1D, glTexImage2D, glTexParameter