WebGLRenderingContext.getTexParameter()

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.

WebGLRenderingContext.getTexParameter()WebGL API方法返回特定的纹理信息。

语法

js
getTexParameter(target, pname)

参数

target

一个 GLenum 接口类型的绑定的点 (target). 可能的值有:

  • gl.TEXTURE_2D: 一个二维纹理。
  • gl.TEXTURE_CUBE_MAP: 一个立方体纹理。
  • 当使用 WebGL 2 context接口,可能会出现以下值:
    • gl.TEXTURE_3D: 一个三维纹理。
    • gl.TEXTURE_2D_ARRAY: 一个二维纹理数组。
pname

一个Glenum接口类型的要查询的信息。可能的值有:

pname 返回的类型 描述 可能返回的值
可用的 WebGL 1 的上下文
gl.TEXTURE_MAG_FILTER GLenum 纹理的放大滤镜 gl.LINEAR (default value), gl.NEAREST.
gl.TEXTURE_MIN_FILTER GLenum 纹理的缩小滤镜 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

封装的纹理坐标方法s(对应 u 坐标)

gl.REPEAT (default value), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T GLenum 封装的纹理坐标方法 t(对应 v 坐标) gl.REPEAT (default value), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
使用 EXT_texture_filter_anisotropic 接口增加可用的扩展方法/属性
ext.TEXTURE_MAX_ANISOTROPY_EXT GLfloat 纹理所有方向的最大值 一个浮点型的任意值。
使用 WebGL 2 上下文之后增加的可用方法/属性
gl.TEXTURE_BASE_LEVEL GLint 纹理贴图层级 一个整型任意值。
gl.TEXTURE_COMPARE_FUNC GLenum 比较方法 gl.LEQUAL (default value), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE GLenum 纹理的比较模式 gl.NONE (default value), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT GLboolean 纹理的格式和尺寸是否可变 true 或者 false.
gl.TEXTURE_IMMUTABLE_LEVELS GLuint 纹理的可变等级 无符号整型任意值。
gl.TEXTURE_MAX_LEVEL GLint 贴图数组层级的最大值 整型任意值。
gl.TEXTURE_MAX_LOD GLfloat 纹理细致程度的最大值 浮点型任意值。
gl.TEXTURE_MIN_LOD GLfloat 纹理细致程度的最小值 浮点型任意值。
gl.TEXTURE_WRAP_R GLenum 封装的纹理坐标方法 r gl.REPEAT (default value), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.

返回值

返回需要的纹理信息 (和 pname类型相同). 如果发生错误,就返回null.

示例

js
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);

规范

Specification
WebGL Specification
# 5.14.8
WebGL 2.0 Specification
# 3.7.6

浏览器兼容性

BCD tables only load in the browser

相关链接