WebGLRenderingContext.bindTexture()

WebGL API 的 WebGLRenderingContext.bindTexture() 方法将给定的 WebGLTexture 绑定到目标（绑定点）。

语法

void gl.bindTexture(target, texture);

参数

target

GLenum (en-US) 指定绑定点（目标）。可能的值：

  • 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

参见