Gl.GenerateMipmapEXT (gb.opengl)

Generate mipmaps for a specified texture target.

Parameters

target

Specifies the target to which the texture whose mipmaps 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

Gl.GenerateMipmap 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 ${\mathit{level}}_{\mathrm{base}}+1$ through $\mathit{q}$ with arrays derived from the ${\mathit{level}}_{\mathrm{base}}$ array, regardless of their previous contents. All other mipmap arrays, including the ${\mathit{level}}_{\mathrm{base}}$ array, are left unchanged by this computation.

The internal formats of the derived mipmap arrays all match those of the ${\mathit{level}}_{\mathrm{base}}$ array. The contents of the derived arrays are computed by repeated, filtered reduction of the ${\mathit{level}}_{\mathrm{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

See original documentation on OpenGL website