The WebGLRenderingContext.generateMipmap()
method of the
WebGL API generates a set of mipmaps for a
WebGLTexture
object.
Mipmaps are used to create distance with objects. A higher-resolution mipmap is used for objects that are closer, and a lower-resolution mipmap is used for objects that are farther away. It starts with the resolution of the texture image and halves the resolution until a 1x1 dimension texture image is created.
Syntax
void gl.generateMipmap(target);
Parameters
- target
- A
GLenum
specifying the binding point (target) of the active texture whose mipmaps will be generated. Possible values:gl.TEXTURE_2D
: A two-dimensional texture.gl.TEXTURE_CUBE_MAP
: A cube-mapped texture.- When using a WebGL 2 context,
the following values are available additionally:
gl.TEXTURE_3D
: A three-dimensional texture.gl.TEXTURE_2D_ARRAY
: A two-dimensional array texture.
Return value
None.
Examples
gl.generateMipmap(gl.TEXTURE_2D);
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'generateMipmap' in that specification. |
Recommendation | Initial definition for WebGL. |
OpenGL ES 2.0 The definition of 'glGenerateMipmap' in that specification. |
Standard | Man page of the (similar) OpenGL ES 2.0 API. |
OpenGL ES 3.0 The definition of 'glGenerateMipmap' in that specification. |
Standard | Man page of the (similar) OpenGL ES 3.0 API. Adds: gl.TEXTURE_3D and gl.TEXTURE_2D_ARRAY |
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.