glInvalidateTexImage — invalidate the entirety a texture image
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.
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.
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.
glGet with argument GL_MAX_TEXTURE_SIZE
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
|
- | - | - | - | - | - | - | - | - | ✔ | ✔ | ✔ |
glInvalidateTexSubImage,, glInvalidateBufferSubData, glInvalidateBufferData, glInvalidateFramebuffer, glInvalidateSubFramebuffer.
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/.