WebGL API 的WebGLRenderingContext.texParameter[fi]()
方法用于设置纹理参数.
语法
void gl.texParameterf(GLenum target, GLenum pname, GLfloat param); void gl.texParameteri(GLenum target, GLenum pname, GLint param);
参数
- target
GLenum
指定绑定点(目标)。可能的值:-
gl.TEXTURE_2D
: 二维纹理.gl.TEXTURE_CUBE_MAP
: 立方体纹理.- 当使用 WebGL 2 context 时,还可以使用以下值
gl.TEXTURE_3D
: 三维贴图.gl.TEXTURE_2D_ARRAY
: 二维数组贴图.
pname
参数是 Glenum
指定要设置的纹理参数. param
参数是 GLfloat
或 GLint
已指定的 pname
参数的值。
pname |
描述 | 参数 |
---|---|---|
Available in WebGL 1 | ||
gl.TEXTURE_MAG_FILTER |
纹理放大滤波器 | gl.LINEAR (默认值), gl.NEAREST . |
gl.TEXTURE_MIN_FILTER |
纹理缩小滤波器 | gl.LINEAR , gl.NEAREST , gl.NEAREST_MIPMAP_NEAREST , gl.LINEAR_MIPMAP_NEAREST , gl.NEAREST_MIPMAP_LINEAR (默认值), gl.LINEAR_MIPMAP_LINEAR . |
gl.TEXTURE_WRAP_S |
纹理坐标水平填充 s |
gl.REPEAT (默认值),gl.CLAMP_TO_EDGE , gl.MIRRORED_REPEAT . |
gl.TEXTURE_WRAP_T |
纹理坐标垂直填充 t |
gl.REPEAT (默认值),gl.CLAMP_TO_EDGE , gl.MIRRORED_REPEAT . |
Additionally available when using the EXT_texture_filter_anisotropic extension |
||
ext.TEXTURE_MAX_ANISOTROPY_EXT |
纹理最大向异性 | GLfloat 值. |
Additionally available when using a WebGL 2 context | ||
gl.TEXTURE_BASE_LEVEL |
纹理映射等级 | 任何整型值. |
gl.TEXTURE_COMPARE_FUNC |
纹理对比函数 | gl.LEQUAL (默认值), gl.GEQUAL , gl.LESS , gl.GREATER , gl.EQUAL , gl.NOTEQUAL , gl.ALWAYS , gl.NEVER . |
gl.TEXTURE_COMPARE_MODE |
纹理对比模式 | gl.NONE (默认值), gl.COMPARE_REF_TO_TEXTURE . |
gl.TEXTURE_MAX_LEVEL |
最大纹理映射数组等级 | 任何整型值. |
gl.TEXTURE_MAX_LOD |
纹理最大细节层次值 | 任何整型值. |
gl.TEXTURE_MIN_LOD |
纹理最小细节层次值 | 任何浮点型值. |
gl.TEXTURE_WRAP_R |
纹理坐标r 包装功能 |
gl.REPEAT (默认值), gl.CLAMP_TO_EDGE , gl.MIRRORED_REPEAT . |
返回值
INVALID_ENUM
target不是合法的值。
INVALID_OPRATION
当前目标上没有绑定纹理对象。
示例
gl.texParameterf(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_NEAREST);
说明
Specification | Status | Comment |
---|---|---|
WebGL 1.0 texParameter[fi] |
Recommendation | WebGL初始定义. |
OpenGL ES 2.0 glTexParameter |
Standard | OpenGL ES 2.0 API手册(类似). |
WebGL 2.0 texParameter[fi] |
Editor's Draft | WebGL更新定义. |
OpenGL ES 3.0 glTexParameter |
Standard | OpenGL ES 3.0 API手册(类似). |
浏览器兼容性
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.