glInvalidateTexImage - OpenGL 4 Reference Pages

## Name

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`

## Version Support

| OpenGL Version
--- | ---
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5
`glInvalidateTexImage` | - | - | - | - | - | - | - | - | - | ✔ | ✔ | ✔

## See Also

glInvalidateTexSubImage,, glInvalidateBufferSubData, glInvalidateBufferData, glInvalidateFramebuffer, glInvalidateSubFramebuffer.

## Copyright

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