glInvalidateTexImage - invalidate the entirety a texture image
Contents
Associated Gets
glGet() with argument GL_MAX_TEXTURE_SIZE
C Specification
voidglInvalidateTexImage(GLuinttexture,GLintlevel);
Copyright
Copyright © 2013-2014 Khronos Group
[FIXME: source] 11/18/2024 GLINVALIDATETEXIMAGE(3G)
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.
Name
glInvalidateTexImage - invalidate the entirety a texture image
Parameters
texture
The name of a texture object to invalidate.
level
The level of detail of the texture object to invalidate.
See Also
glInvalidateTexSubImage(),, glInvalidateBufferSubData(), glInvalidateBufferData(),
glInvalidateFramebuffer(), glInvalidateSubFramebuffer().
Version Support
┌──────────────────────┬───────────────────────────────────────────────────────────────────────┐
│ │ OpenGLVersion │
├──────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
│ Function │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
│ / │ │ │ │ │ │ │ │ │ │ │ │ │
│ Feature │ │ │ │ │ │ │ │ │ │ │ │ │
│ Name │ │ │ │ │ │ │ │ │ │ │ │ │
├──────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
│ glInvalidateTexImage │ - │ - │ - │ - │ - │ - │ - │ - │ - │ ✔ │ ✔ │ ✔ │
└──────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘
