WebGLRenderingContext: generateMipmap() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available in Web Workers.
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
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 (undefined
).
Examples
gl.generateMipmap(gl.TEXTURE_2D);
Specifications
Specification |
---|
WebGL Specification # 5.14.8 |
Browser compatibility
BCD tables only load in the browser