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             │ 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 │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │  ✔  │  ✔  │
       └─────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘

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

COPYRIGHT

       Copyright © 2013-2014 Khronos Group

[FIXME: source]                             07/22/2015                   GLINVALIDATETEXIMAGE(3G)