GLAPI/glGenerateMipmap

From OpenGL.org
Jump to: navigation, search
glGenerateMipmap
Core in version 4.4
Core since version 3.0

glGenerateMipmap: generate mipmaps for a specified texture target

Function Definition

 void glGenerateMipmap(GLenum target​);
target
Specifies the target to which the texture whose mimaps to generate is bound. target​ must be 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​.

Description

glGenerateMipmap generates mipmaps for the texture attached to target​ of the active texture unit. For cube map textures, a GL_INVALID_OPERATION​ error is generated if the texture attached to target​ is not cube complete.

Mipmap generation replaces texel array levels levelbase + 1 through q with arrays derived from the levelbase array, regardless of their previous contents. All other mimap arrays, including the levelbase array, are left unchanged by this computation.

The internal formats of the derived mipmap arrays all match those of the levelbase array. The contents of the derived arrays are computed by repeated, filtered reduction of the levelbase array. For one- and two-dimensional texture arrays, each layer is filtered independently.

Errors

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

GL_INVALID_OPERATION​ is generated if target​ is GL_TEXTURE_CUBE_MAP​ and the texture bound to the GL_TEXTURE_CUBE_MAP​ target of the active texture unit is not cube complete.

See Also

glActiveTexture, glBindTexture, glTexImage1D, glTexImage2D, glTexImage3D, glTexStorage1D, glTexStorage2D, glTexStorage3D

Copyright

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