NAME

       glGenerateMipmap, glGenerateTextureMipmap - generate mipmaps for a specified texture
       object

C SPECIFICATION

       void glGenerateMipmap(GLenum target);

       void glGenerateTextureMipmap(GLuint texture);

PARAMETERS

       target
           Specifies the target to which the texture object is bound for glGenerateMipmap. Must
           be one of GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_1D_ARRAY,
           GL_TEXTURE_2D_ARRAY, GL_TEXTURE_CUBE_MAP, or GL_TEXTURE_CUBE_MAP_ARRAY.

       texture
           Specifies the texture object name for glGenerateTextureMipmap.

DESCRIPTION

       glGenerateMipmap and glGenerateTextureMipmap generates mipmaps for the specified texture
       object. For glGenerateMipmap, the texture object is that bound to to target. For
       glGenerateTextureMipmap, texture is the name of the texture object.

       For cube map and cube map array textures, the texture object must be cube complete or cube
       array complete respectively.

       Mipmap generation replaces texel image levels $level_{base} + 1$ through $q$ with images
       derived from the $level_{base}$ image, regardless of their previous contents. All other
       mimap images, including the $level_{base}+1$ image, are left unchanged by this
       computation.

       The internal formats of the derived mipmap images all match those of the $level_{base}$
       image. The contents of the derived images are computed by repeated, filtered reduction of
       the $level_{base} + 1$ image. For one- and two-dimensional array and cube map array
       textures, each layer is filtered independently.

NOTES

       Cube map array textures are accepted only if the GL version is 4.0 or higher.

ERRORS

       GL_INVALID_ENUM is generated by glGenerateMipmap if target is not one of the accepted
       texture targets.

       GL_INVALID_OPERATION is generated by glGenerateTextureMipmap if texture is not the name of
       an existing texture object.

       GL_INVALID_OPERATION is generated if target is GL_TEXTURE_CUBE_MAP or
       GL_TEXTURE_CUBE_MAP_ARRAY, and the specified texture object is not cube complete or cube
       array complete, respectively.

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                    │     │     │     │     │     │     │     │     │     │     │     │     │
       ├────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │glGenerateMipmap        │  -  │  -  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
       ├────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │glGenerateTextureMipmap │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
       └────────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘

SEE ALSO

       glTexImage2D(), glBindTexture(), glGenTextures()

COPYRIGHT

       Copyright © 2010-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 © 2010-2014 Khronos Group

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