WebGLRenderingContext.bindTexture()
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.
WebGL API 的 WebGLRenderingContext.bindTexture()
方法将给定的 WebGLTexture
绑定到目标(绑定点)。
语法
void gl.bindTexture(target, texture);
参数
- target
-
GLenum
指定绑定点(目标)。可能的值:-
gl.TEXTURE_2D
: 二维纹理。 -
gl.TEXTURE_CUBE_MAP
: 立方体映射纹理。 -
当使用 WebGL 2 context 时,可以使用以下值:
gl.TEXTURE_3D
: 三维纹理。gl.TEXTURE_2D_ARRAY
: 二维数组纹理。
-
- texture
-
要绑定的
WebGLTexture
对象。
返回值
无。
异常
如果目标不是 gl.TEXTURE_2D,gl.TEXTURE_CUBE_MAP,gl.TEXTURE_3D 或 gl.TEXTURE_2D_ARRAY,则会抛出 gl.INVALID_ENUM 错误。
示例
绑定纹理
js
var canvas = document.getElementById("canvas");
var gl = canvas.getContext("webgl");
var texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
获取当前绑定
要检查当前纹理绑定,请查询 gl.TEXTURE_BINDING_2D 或 gl.TEXTURE_BINDING_CUBE_MAP 常量。
js
gl.getParameter(gl.TEXTURE_BINDING_2D);
规范
Specification |
---|
WebGL Specification # 5.14.8 |
WebGL 2.0 Specification # 3.7.1 |
浏览器兼容性
BCD tables only load in the browser