The WebGLRenderingContext.getTexParameter() method of the WebGL API returns information about the given texture.
On this page
WebGLRenderingContext: getTexParameter() method
Syntax
js
getTexParameter(target, pname)
Parameters
-
target -
A
GLenumspecifying the binding point (target). 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.
-
pname -
A
GLenumspecifying the information to query. Possible values:pname Return type Description Possible return values Available in a WebGL 1 context gl.TEXTURE_MAG_FILTERGLenumTexture magnification filter gl.LINEAR(default value),gl.NEAREST.gl.TEXTURE_MIN_FILTERGLenumTexture minification filter gl.LINEAR,gl.NEAREST,gl.NEAREST_MIPMAP_NEAREST,gl.LINEAR_MIPMAP_NEAREST,gl.NEAREST_MIPMAP_LINEAR (default value),gl.LINEAR_MIPMAP_LINEAR.gl.TEXTURE_WRAP_SGLenumWrapping function for texture coordinate sgl.REPEAT(default value),gl.CLAMP_TO_EDGE,gl.MIRRORED_REPEAT.gl.TEXTURE_WRAP_TGLenumWrapping function for texture coordinate tgl.REPEAT(default value),gl.CLAMP_TO_EDGE,gl.MIRRORED_REPEAT.Additionally available when using the EXT_texture_filter_anisotropicextensionext.TEXTURE_MAX_ANISOTROPY_EXTGLfloatMaximum anisotropy for a texture Any float values. Additionally available when using a WebGL 2 context gl.TEXTURE_BASE_LEVELGLintTexture mipmap level Any int values. gl.TEXTURE_COMPARE_FUNCGLenumComparison function gl.LEQUAL(default value),gl.GEQUAL,gl.LESS,gl.GREATER,gl.EQUAL,gl.NOTEQUAL,gl.ALWAYS,gl.NEVER.gl.TEXTURE_COMPARE_MODEGLenumTexture comparison mode gl.NONE(default value),gl.COMPARE_REF_TO_TEXTURE.gl.TEXTURE_IMMUTABLE_FORMATGLbooleanImmutability of the texture format and size true or false. gl.TEXTURE_IMMUTABLE_LEVELSGLuint? Any uint values. gl.TEXTURE_MAX_LEVELGLintMaximum texture mipmap array level Any int values. gl.TEXTURE_MAX_LODGLfloatTexture maximum level-of-detail value Any float values. gl.TEXTURE_MIN_LODGLfloatTexture minimum level-of-detail value Any float values. gl.TEXTURE_WRAP_RGLenumWrapping function for texture coordinate rgl.REPEAT(default value),gl.CLAMP_TO_EDGE,gl.MIRRORED_REPEAT.
Return value
Returns the requested texture information (as specified with pname). If an error occurs, null is returned.
Examples
js
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);
Specifications
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.6 |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getTexParameter |
9 | 12 | 4 | 11 | 12 | 5.1 | 4.4.3 | 25 | 4 | 12 | 8 | 1.5 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/getTexParameter