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