WebGLRenderingContext: texParameter[fi]() 方法

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.texParameter[fi]() 方法属于 WebGL API,用于设置纹理参数。

语法

js
texParameterf(target, pname, param)
texParameteri(target, pname, param)

参数

目标

一个 GLenum,指定绑定点(目标)。可能的值

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

使用 WebGL 2 上下文时,还可以使用以下值:

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

param 参数是一个 GLfloatGLint,指定了给定参数的值。

pname

pname 参数是一个 GLenum,指定了要设置的纹理参数。

pname 描述 pname
在 WebGL 1 中可用
gl.TEXTURE_MAG_FILTER 纹理放大过滤器 gl.LINEAR (默认值),gl.NEAREST
gl.TEXTURE_MIN_FILTER 纹理缩小过滤器 gl.LINEARgl.NEARESTgl.NEAREST_MIPMAP_NEARESTgl.LINEAR_MIPMAP_NEARESTgl.NEAREST_MIPMAP_LINEAR (默认值),gl.LINEAR_MIPMAP_LINEAR
gl.TEXTURE_WRAP_S 纹理坐标 s 的环绕函数 gl.REPEAT (默认值),gl.CLAMP_TO_EDGEgl.MIRRORED_REPEAT
gl.TEXTURE_WRAP_T 纹理坐标 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 纹理Mipmap 级别 任何整数值。
gl.TEXTURE_COMPARE_FUNC 纹理比较函数 gl.LEQUAL (默认值),gl.GEQUALgl.LESSgl.GREATERgl.EQUALgl.NOTEQUALgl.ALWAYSgl.NEVER
gl.TEXTURE_COMPARE_MODE 纹理比较模式 gl.NONE (默认值),gl.COMPARE_REF_TO_TEXTURE
gl.TEXTURE_MAX_LEVEL 最大纹理 Mipmap 数组级别 任何整数值。
gl.TEXTURE_MAX_LOD 纹理最大细节级别值 任何浮点数值。
gl.TEXTURE_MIN_LOD 纹理最小细节级别值 任何浮点数值。
gl.TEXTURE_WRAP_R 纹理坐标 r 的环绕函数 gl.REPEAT (默认值),gl.CLAMP_TO_EDGEgl.MIRRORED_REPEAT

返回值

无(undefined)。

示例

js
gl.texParameterf(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.texParameteri(
  gl.TEXTURE_2D,
  gl.TEXTURE_MIN_FILTER,
  gl.LINEAR_MIPMAP_NEAREST,
);

规范

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

浏览器兼容性

api.WebGLRenderingContext.texParameterf

api.WebGLRenderingContext.texParameteri

另见