WebGLRenderingContext.bindTexture()

这篇翻译不完整。请帮忙从英语翻译这篇文章

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: A three-dimensional texture.
    • gl.TEXTURE_2D_ARRAY: A two-dimensional array texture.
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 Initial definition for WebGL.
OpenGL ES 2.0
glBindTexture
Standard Man page of the (similar) OpenGL ES 2.0 API.
WebGL 2.0
bindTexture
Editor's Draft Updated definition for WebGL 2.
Adds: gl.TEXTURE_3D and gl.TEXTURE_2D_ARRAY
OpenGL ES 3.0
glBindTexture
Standard Man page of the (similar) OpenGL ES 3.0 API.

浏览器兼容性

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

另见

文档标签和贡献者

此页面的贡献者: Sylvia_Y, C0DE_MONKEY
最后编辑者: Sylvia_Y,