2010-2013
Khronos Group
glGenerateMipmap
3G
glGenerateMipmap
generate mipmaps for a specified texture target
C Specification
void glGenerateMipmap
GLenum target
Parameters
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 or
GL_TEXTURE_CUBE_MAP.
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
level
base
+
1
through
q
with arrays derived from the
level
base
array, regardless of their previous contents. All other mimap arrays,
including the
level
base
array, are left unchanged by this computation.
The internal formats of the derived mipmap arrays all match those of the
level
base
array. The contents of the derived arrays are computed by repeated, filtered
reduction of the
level
base
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
glTexImage2D,
glBindTexture,
glGenTextures
Copyright
Copyright 2010-2013 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/.