GLAPI/glInvalidateTexImage

From OpenGL.org
Jump to: navigation, search
glInvalidateTexImage
Core in version 4.4
Core since version 4.3
Core ARB extension ARB_invalidate_subdata

glInvalidateTexImage: invalidate the entirety a texture image

Function Definition

 void glInvalidateTexImage(GLuint texture​, GLint level​);
texture
The name of a texture object to invalidate.
level
The level of detail of the texture object to invalidate.

Description

glInvalidateTexSubImage invalidates all of a texture image. texture​ and level​ indicated which texture image is being invalidated. After this command, data in the texture image has undefined values.

level​ must be greater than or equal to zero and be less than the base 2 logarithm of the maximum texture width, height, or depth.

For textures of targets GL_TEXTURE_RECTANGLE​, GL_TEXTURE_BUFFER​, GL_TEXTURE_2D_MULTISAMPLE​, or GL_TEXTURE_2D_MULTISAMPLE_ARRAY​, level must be zero.

Errors

GL_INVALID_VALUE​ is generated if level​ is less than zero or if it is greater or equal to the base 2 logarithm of the maximum texture width, height, or depth.

GL_INVALID_VALUE​ is generated if the target of texture​ is any of GL_TEXTURE_RECTANGLE​, GL_TEXTURE_BUFFER​, GL_TEXTURE_2D_MULTISAMPLE​, or GL_TEXTURE_2D_MULTISAMPLE_ARRAY​ and level​ is not zero.

GL_INVALID_VALUE​ is generated if texture​ is not the name of an existing texture object.

Associated Gets

glGet with argument GL_MAX_TEXTURE_SIZE​

See Also

glInvalidateTexSubImage, glInvalidateFramebuffer, glInvalidateSubFramebuffer

Copyright

Copyright © 2012 Khronos Group. 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/.