WebGLRenderingContext: getTexParameter() method

Note: This feature is available in Web Workers.

The WebGLRenderingContext.getTexParameter() method of the WebGL API returns information about the given texture.

Syntax

js
getTexParameter(target, pname)

Parameters

target

A GLenum specifying the binding point (target). Possible values:

When using a WebGL 2 context, the following values are available additionally:

pname

A GLenum specifying the information to query. Possible values:

pnameReturn typeDescriptionPossible return values
Available in a WebGL 1 context
gl.TEXTURE_MAG_FILTERGLenumTexture magnification filtergl.LINEAR (default value), gl.NEAREST.
gl.TEXTURE_MIN_FILTERGLenumTexture minification filtergl.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_anisotropic extension
ext.TEXTURE_MAX_ANISOTROPY_EXTGLfloatMaximum anisotropy for a textureAny float values.
Additionally available when using a WebGL 2 context
gl.TEXTURE_BASE_LEVELGLintTexture mipmap levelAny int values.
gl.TEXTURE_COMPARE_FUNCGLenumComparison functiongl.LEQUAL (default value), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODEGLenumTexture comparison modegl.NONE (default value), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMATGLbooleanImmutability of the texture format and sizetrue or false.
gl.TEXTURE_IMMUTABLE_LEVELSGLuint?Any uint values.
gl.TEXTURE_MAX_LEVELGLintMaximum texture mipmap array levelAny int values.
gl.TEXTURE_MAX_LODGLfloatTexture maximum level-of-detail valueAny float values.
gl.TEXTURE_MIN_LODGLfloatTexture minimum level-of-detail valueAny 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

See also