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 APIWebGLRenderingContext.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

参见