WebGLRenderingContext.bindTexture()

This translation is incomplete. Please help translate this article from English

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 错误。

示例

绑定纹理

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常量。

gl.getParameter(gl.TEXTURE_BINDING_2D);

规范

Specification Status Comment
WebGL 1.0
bindTexture
Recommendation WebGL初始定义。
OpenGL ES 2.0
glBindTexture
Standard OpenGL ES 2.0 API手册(类似).
WebGL 2.0
bindTexture
Editor's Draft WebGL 2更新定义。
增加: gl.TEXTURE_3D and gl.TEXTURE_2D_ARRAY
OpenGL ES 3.0
glBindTexture
Standard OpenGL ES 3.0 API手册(类似)。

浏览器兼容性

No compatibility data found. Please contribute data for "api/WebGLRenderingContext" (depth: WebGLRenderingContext.bindTexture) to the MDN compatibility data repository.

另见