WebGLRenderingContext:bindTexture() 方法

基线 广泛可用

此功能已得到良好确立,并且可在许多设备和浏览器版本中使用。它自 2015 年 7 月.

报告反馈

语法

js
bindTexture(target, texture)

参数

target

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

  • gl.TEXTURE_2D:二维纹理。
  • gl.TEXTURE_CUBE_MAP:立方体贴图纹理。当使用 WebGL 2 上下文 时,以下值也可使用
    • gl.TEXTURE_3D:三维纹理。
    • gl.TEXTURE_2D_ARRAY:二维数组纹理。
texture

要绑定的 WebGLTexture 对象。

返回值

无 (undefined)。

异常

如果 target 不是 gl.TEXTURE_2Dgl.TEXTURE_CUBE_MAPgl.TEXTURE_3Dgl.TEXTURE_2D_ARRAY,则会抛出 gl.INVALID_ENUM 错误。

示例

绑定纹理

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();

gl.bindTexture(gl.TEXTURE_2D, texture);

获取当前绑定

要检查当前纹理绑定,请查询 gl.TEXTURE_BINDING_2Dgl.TEXTURE_BINDING_CUBE_MAP 常量。

js
gl.getParameter(gl.TEXTURE_BINDING_2D);

规范

规范
WebGL 规范
# 5.14.8
WebGL 2.0 规范
# 3.7.1

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅