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_2D
、gl.TEXTURE_CUBE_MAP
、gl.TEXTURE_3D
或 gl.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_2D
或 gl.TEXTURE_BINDING_CUBE_MAP
常量。
js
gl.getParameter(gl.TEXTURE_BINDING_2D);
规范
规范 |
---|
WebGL 规范 # 5.14.8 |
WebGL 2.0 规范 # 3.7.1 |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。