此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

WebGLRenderingContext.bindFramebuffer()

WebGL API 的 WebGLRenderingContext.bindFramebuffer() 方法将给定的 WebGLFramebuffer 绑定到目标。

语法

void gl.bindFramebuffer(target, framebuffer);

参数

target
GLenum (en-US) 指定绑定点 (目标)。可能的值为：
  • gl.FRAMEBUFFER: 收集用于渲染图像的颜色，alpha，深度和模板缓冲区的缓冲区数据存储。
  • 当使用 WebGL 2 context 时，可以使用以下值：
    • gl.DRAW_FRAMEBUFFER: 相当于gl.FRAMEBUFFER， 用作绘图，渲染，清除和写入操作。
    • gl.READ_FRAMEBUFFER: 用作读取操作的资源。
framebuffer
要绑定的 WebGLFramebuffer 对象。

返回值

None.

异常

如果目标不是 gl.FRAMEBUFFER ，gl.DRAW_FRAMEBUFFER 或 gl.READ_FRAMEBUFFER ，则抛出 gl.INVALID_ENUM 错误。

示例

绑定帧缓冲区

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var framebuffer = gl.createFramebuffer();

gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);

获取当前绑定

要检查当前帧缓冲区绑定，请查询 FRAMEBUFFER_BINDING 常量。

gl.getParameter(gl.FRAMEBUFFER_BINDING);

规范

Specification Status Comment
WebGL 1.0
bindFramebuffer		 Recommendation WebGL 初始定义。
OpenGL ES 2.0
glBindFramebuffer		 Standard OpenGL API 手册。
WebGL 2.0
bindFrameBuffer		 Editor's Draft WebGL 2 更新定义。
新增：gl.DRAW_FRAMEBUFFER 和 gl.READ_FRAMEBUFFER
OpenGL ES 3.0
glBindFramebuffer		 Standard OpenGL ES 3 API 手册 (类似).

浏览器兼容性

No compatibility data found for api/WebGLRenderingContext.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

另见