GLAPI/glGenerateMipmap: Difference between revisions
No edit summary |
m fix 'mimap' typos |
||
| (One intermediate revision by one other user not shown) | |||
| Line 11: | Line 11: | ||
; target | ; target | ||
: Specifies the target to which the texture whose | : Specifies the target to which the texture whose mipmaps to generate is bound. {{param|target}} must be {{enum|GL_TEXTURE_1D}}, {{enum|GL_TEXTURE_2D}}, {{enum|GL_TEXTURE_3D}}, {{enum|GL_TEXTURE_1D_ARRAY}}, {{enum|GL_TEXTURE_2D_ARRAY}}, {{enum|GL_TEXTURE_CUBE_MAP}}, or {{enum|GL_TEXTURE_CUBE_MAP_ARRAY}}. | ||
== Description == | == Description == | ||
| Line 17: | Line 17: | ||
'''glGenerateMipmap''' generates mipmaps for the texture attached to {{param|target}} of the active texture unit. For cube map textures, a {{enum|GL_INVALID_OPERATION}} error is generated if the texture attached to {{param|target}} is not cube complete. | '''glGenerateMipmap''' generates mipmaps for the texture attached to {{param|target}} of the active texture unit. For cube map textures, a {{enum|GL_INVALID_OPERATION}} error is generated if the texture attached to {{param|target}} is not cube complete. | ||
Mipmap generation replaces texel array levels ''level<sub>base</sub>'' + 1 through ''q'' with arrays derived from the ''level<sub>base</sub>'' array, regardless of their previous contents. All other | Mipmap generation replaces texel array levels ''level<sub>base</sub>'' + 1 through ''q'' with arrays derived from the ''level<sub>base</sub>'' array, regardless of their previous contents. All other mipmap arrays, including the ''level<sub>base</sub>'' array, are left unchanged by this computation. | ||
The internal formats of the derived mipmap arrays all match those of the ''level<sub>base</sub>'' array. The contents of the derived arrays are computed by repeated, filtered reduction of the ''level<sub>base</sub>'' array. For one- and two-dimensional texture arrays, each layer is filtered independently. | The internal formats of the derived mipmap arrays all match those of the ''level<sub>base</sub>'' array. The contents of the derived arrays are computed by repeated, filtered reduction of the ''level<sub>base</sub>'' array. For one- and two-dimensional texture arrays, each layer is filtered independently. | ||
| Line 37: | Line 37: | ||
[[Category:Core API Reference|GenerateMipmap]] | [[Category:Core API Reference|GenerateMipmap]] | ||
[[Category:Core API Ref Texturing|GenerateMipmap]] | [[Category:Core API Ref Texturing|GenerateMipmap]] | ||
[[Category:Texture Object API State Functions|GenerateMipmap]] | |||
Latest revision as of 19:20, 24 November 2018
| Core in version | 4.6 | |
|---|---|---|
| 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 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, 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 mipmap 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/.