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
: 三维纹理.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手册(类似)。 |
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.