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.NOTEQUAL
,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
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.