The WebGLRenderingContext.getTexParameter()
method of the WebGL API returns information about the given texture.
Syntax
any gl.getTexParameter(target, pname);
Parameters
- target
- A
GLenum
specifying 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
Glenum
specifying the information to query. Possible values:pname Return type Description Possible return values Available in a WebGL 1 context gl.TEXTURE_MAG_FILTER
GLenum
Texture magnification filter gl.LINEAR
(default value),gl.NEAREST
.gl.TEXTURE_MIN_FILTER
GLenum
Texture 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_S
GLenum
Wrapping function for texture coordinate s
gl.REPEAT
(default value),gl.CLAMP_TO_EDGE
,gl.MIRRORED_REPEAT
.gl.TEXTURE_WRAP_T
GLenum
Wrapping function for texture coordinate t
gl.REPEAT
(default value),gl.CLAMP_TO_EDGE
,gl.MIRRORED_REPEAT
.Additionally available when using the EXT_texture_filter_anisotropic
extensionext.TEXTURE_MAX_ANISOTROPY_EXT
GLfloat
Maximum anisotropy for a texture Any float values. Additionally available when using a WebGL 2 context gl.TEXTURE_BASE_LEVEL
GLint
Texture mipmap level Any int values. gl.TEXTURE_COMPARE_FUNC
GLenum
Comparison function gl.LEQUAL
(default value),gl.GEQUAL
,gl.LESS
,gl.GREATER
,gl.EQUAL
,gl.NOT_EQUAL
,gl.ALWAYS
,gl.NEVER
.gl.TEXTURE_COMPARE_MODE
GLenum
Texture comparison mode gl.NONE
(default value),gl.COMPARE_REF_TO_TEXTURE
.gl.TEXTURE_IMMUTABLE_FORMAT
GLboolean
Immutability of the texture format and size true or false. gl.TEXTURE_IMMUTABLE_LEVELS
GLuint
? Any uint values. gl.TEXTURE_MAX_LEVEL
GLint
Maximum texture mipmap array level Any int values. gl.TEXTURE_MAX_LOD
GLfloat
Texture maximum level-of-detail value Any float values. gl.TEXTURE_MIN_LOD
GLfloat
Texture minimum level-of-detail value Any float values. gl.TEXTURE_WRAP_R
GLenum
Wrapping function for texture coordinate r
gl.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
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 1.0 The definition of 'getTexParameter' in that specification. |
Recommendation | Initial definition for WebGL. |
OpenGL ES 2.0 The definition of 'glGetTexParameter' in that specification. |
Standard | Man page of the (similar) OpenGL ES 2.0 API. |
WebGL 2.0 The definition of 'getTexParameter' in that specification. |
Editor's Draft | Updated definition for WebGL. |
OpenGL ES 3.0 The definition of 'glGetTexParameter' in that specification. |
Standard | Man page of the (similar) OpenGL ES 3.0 API. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 9 | 12 | 4.0 (2.0) | 11 | 12 | 5.1 |
WebGL 2 | No support [2] | No support | Nightly build [1] | No support | No support | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | ? | 25 | 4.0 (2.0) | 1.0 | ? | 12 | 8.0 |
WebGL 2 | No support | No support | No support | No support | No support | No support | No support |
[1] WebGL 2 is enabled by default in Firefox Nightly. To enable it in a release version of Firefox, set the preference webgl.enable-prototype-webgl2
to true
in about:config.
[2] To use an experimental implementation of WebGL 2 in Chrome, you have to start Chrome with the runtime flag --enable-unsafe-es3-apis
.