WebGLRenderingContext:getTexParameter() 方法

基线 广泛可用

此功能已得到良好确立,并且可在许多设备和浏览器版本中使用。它自 2015 年 7 月.

反馈报告

语法

WebGLRenderingContext.getTexParameter() 方法是 WebGL API 的一部分,用于返回有关给定纹理的信息。
getTexParameter(target, pname)

参数

target

指定绑定点(目标)的 GLenum。可能的取值

  • gl.TEXTURE_2D:二维纹理。
  • gl.TEXTURE_CUBE_MAP:立方体贴图纹理。

在使用 WebGL 2 上下文 时,以下值也可用

  • gl.TEXTURE_3D:三维纹理。
  • gl.TEXTURE_2D_ARRAY:二维数组纹理。
pname

指定要查询的信息的 GLenum。可能的取值

pname 返回类型 描述 可能的返回值
在 WebGL 1 上下文中可用
gl.TEXTURE_MAG_FILTER GLenum 纹理放大过滤器 gl.LINEAR(默认值),gl.NEAREST
gl.TEXTURE_MIN_FILTER GLenum 纹理缩小过滤器 gl.LINEARgl.NEARESTgl.NEAREST_MIPMAP_NEARESTgl.LINEAR_MIPMAP_NEARESTgl.NEAREST_MIPMAP_LINEAR(默认值)、gl.LINEAR_MIPMAP_LINEAR
gl.TEXTURE_WRAP_S GLenum 纹理坐标 s 的环绕函数 gl.REPEAT(默认值),gl.CLAMP_TO_EDGEgl.MIRRORED_REPEAT
gl.TEXTURE_WRAP_T GLenum 纹理坐标 t 的环绕函数 gl.REPEAT(默认值),gl.CLAMP_TO_EDGEgl.MIRRORED_REPEAT
在使用 EXT_texture_filter_anisotropic 扩展时额外可用
ext.TEXTURE_MAX_ANISOTROPY_EXT GLfloat 纹理的最大各向异性 任何浮点值。
在使用 WebGL 2 上下文时额外可用
gl.TEXTURE_BASE_LEVEL GLint 纹理 mipmap 级别 任何整数。
gl.TEXTURE_COMPARE_FUNC GLenum 比较函数 gl.LEQUAL(默认值),gl.GEQUALgl.LESSgl.GREATERgl.EQUALgl.NOTEQUALgl.ALWAYSgl.NEVER
gl.TEXTURE_COMPARE_MODE GLenum 纹理比较模式 gl.NONE(默认值),gl.COMPARE_REF_TO_TEXTURE
gl.TEXTURE_IMMUTABLE_FORMAT GLboolean 纹理格式和大小的不可变性 true 或 false。
gl.TEXTURE_IMMUTABLE_LEVELS GLuint ? 任何无符号整数。
gl.TEXTURE_MAX_LEVEL GLint 最大纹理 mipmap 数组级别 任何整数。
gl.TEXTURE_MAX_LOD GLfloat 纹理最大细节级别值 任何浮点值。
gl.TEXTURE_MIN_LOD GLfloat 纹理最小细节级别值 任何浮点值。
gl.TEXTURE_WRAP_R GLenum 纹理坐标 r 的环绕函数 gl.REPEAT(默认值),gl.CLAMP_TO_EDGEgl.MIRRORED_REPEAT

返回值

返回请求的纹理信息(由 pname 指定)。如果发生错误,则返回 null

示例

WebGLRenderingContext.getTexParameter() 方法是 WebGL API 的一部分,用于返回有关给定纹理的信息。
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);

规范

规范
WebGL 规范
# 5.14.8
WebGL 2.0 规范
# 3.7.6

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅