2013
Khronos Group
glInvalidateTexImage
3G

# glInvalidateTexImage

invalidate the entirety a texture image

## C Specification

                    void glInvalidateTexImage
                    GLuint texture
                    GLint level

## Parameters

`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,, glInvalidateBufferSubData, glInvalidateBufferData, glInvalidateFramebuffer, glInvalidateSubFramebuffer.

## Copyright

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