Web 图形与 3D / 系统课时
将场景画面写入帧缓冲纹理
将场景画面写入帧缓冲纹理
默认帧缓冲把结果直接送往画布,无法方便地把整幅场景作为纹理再使用。本课创建一个 640×360 的离屏帧缓冲:先绘制彩色三角形并完成深度测试,再切回默认帧缓冲采样颜色纹理,最终在画布上显示同一画面。
学习目标
- 创建颜色纹理与深度渲染缓冲附件,并检查
Framebuffer完整性。 - 使用
gl.bindFramebuffer()完成离屏绘制和屏幕合成两遍渲染。 - 识别附件不完整、纹理反馈、视口不匹配等问题。
颜色与深度怎样挂到离屏目标上
WebGLFramebuffer 负责组织绘制目标,并不自行存储颜色像素。这里把一张 640×360、RGBA8 格式的 TEXTURE_2D 连接到 COLOR_ATTACHMENT0,这样第一遍绘制结果就保留在可采样纹理中。纹理最小过滤器设置为 LINEAR,避免默认过滤模式要求不存在的 Mipmap 层级。
场景含有前后遮挡时,再创建 DEPTH_COMPONENT16 格式的 Renderbuffer,接入 DEPTH_ATTACHMENT。它只用于深度测试,第二遍并不采样深度。若只渲染没有深度测试需求的二维内容,可省略深度附件及相应的深度清除和测试。

运行两遍绘制的完整示例
把下面内容保存为 index.html 并用支持 WebGL 2 的浏览器打开。示例使用 gl_VertexID 生成三角形和全屏三角形,因此不需要上传顶点缓冲;仍显式绑定一个 VAO。创建附件后立即检查 gl.FRAMEBUFFER_COMPLETE,发现配置错误就停止绘制。
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>WebGL 2 离屏渲染</title></head>
<body>
<canvas id="view" width="640" height="360"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("浏览器未提供 WebGL 2");
function makeProgram(vSrc, fSrc) {
function compile(type, source) {
const s = gl.createShader(type);
gl.shaderSource(s, source);
gl.compileShader(s);
if (!gl.getShaderParameter(s, gl.COMPILE_STATUS)) {
throw new Error(gl.getShaderInfoLog(s));
}
return s;
}
const vs = compile(gl.VERTEX_SHADER, vSrc);
const fs = compile(gl.FRAGMENT_SHADER, fSrc);
const program = gl.createProgram();
gl.attachShader(program, vs);
gl.attachShader(program, fs);
gl.linkProgram(program);
gl.deleteShader(vs);
gl.deleteShader(fs);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
return program;
}
const sceneProgram = makeProgram(
`#version 300 es
precision highp float;
out vec3 vColor;
void main() {
vec2 p[3] = vec2[3](vec2(-0.7,-0.7), vec2(0.7,-0.7), vec2(0.0,0.7));
vec3 c[3] = vec3[3](vec3(1.0,0.3,0.2), vec3(0.3,0.9,0.5), vec3(0.2,0.5,1.0));
gl_Position = vec4(p[gl_VertexID], 0.2, 1.0);
vColor = c[gl_VertexID];
}`,
`#version 300 es
precision highp float;
in vec3 vColor;
out vec4 fragColor;
void main() { fragColor = vec4(vColor, 1.0); }`
);
const screenProgram = makeProgram(
`#version 300 es
precision highp float;
out vec2 vUV;
void main() {
vec2 p[3] = vec2[3](vec2(-1.0,-1.0), vec2(3.0,-1.0), vec2(-1.0,3.0));
vec2 pos = p[gl_VertexID];
gl_Position = vec4(pos, 0.0, 1.0);
vUV = pos * 0.5 + 0.5;
}`,
`#version 300 es
precision highp float;
in vec2 vUV;
uniform sampler2D uScene;
out vec4 fragColor;
void main() { fragColor = texture(uScene, vUV); }`
);
// 本例顶点位置由 gl_VertexID 决定,VAO 不包含额外顶点属性。
gl.bindVertexArray(gl.createVertexArray());
const w = canvas.width, h = canvas.height;
// 颜色纹理既是第一遍的写入附件,也是第二遍的采样输入。
const color = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, color);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, w, h, 0,
gl.RGBA, gl.UNSIGNED_BYTE, null);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
gl.bindTexture(gl.TEXTURE_2D, null);
// 深度不需要作为纹理读取,使用 Renderbuffer 即可。
const depth = gl.createRenderbuffer();
gl.bindRenderbuffer(gl.RENDERBUFFER, depth);
gl.renderbufferStorage(gl.RENDERBUFFER, gl.DEPTH_COMPONENT16, w, h);
const fbo = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
gl.TEXTURE_2D, color, 0);
gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT,
gl.RENDERBUFFER, depth);
const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
if (status !== gl.FRAMEBUFFER_COMPLETE) {
throw new Error("离屏帧缓冲不完整: 0x" + status.toString(16));
}
console.log("Framebuffer complete:", true);
// 第一遍:绑定离屏目标,清除颜色和深度并绘制场景。
gl.viewport(0, 0, w, h);
gl.enable(gl.DEPTH_TEST);
gl.clearColor(0.08, 0.12, 0.20, 1.0);
gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
gl.useProgram(sceneProgram);
gl.drawArrays(gl.TRIANGLES, 0, 3);
// 第二遍:切回画布,禁用深度测试并采样离屏颜色纹理。
gl.bindFramebuffer(gl.FRAMEBUFFER, null);
gl.viewport(0, 0, canvas.width, canvas.height);
gl.disable(gl.DEPTH_TEST);
gl.clearColor(0.0, 0.0, 0.0, 1.0);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.useProgram(screenProgram);
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, color);
gl.uniform1i(gl.getUniformLocation(screenProgram, "uScene"), 0);
gl.drawArrays(gl.TRIANGLES, 0, 3);
</script>
</body>
</html>预期结果:页面出现深蓝底色和内部平滑过渡的彩色三角形;开发者工具 Console 输出:
Framebuffer complete: true注意这个结果先写入离屏颜色纹理,再由屏幕着色器读取,并非第一遍直接绘制到画布。将第二遍的 texture(uScene, vUV) 改为 vec4(vec3(texture(uScene, vUV).r), 1.0),就能验证后处理确实发生在采样阶段:画布会显示由红色通道生成的灰度图。
绑定目标与视口必须成对切换
gl.bindFramebuffer(gl.FRAMEBUFFER, fbo) 让后续清除、深度测试和绘制写入离屏附件;绑定 null 才返回默认帧缓冲。gl.viewport() 不会随 FBO 自动切换,因此每一遍都应设置与当前目标一致的像素范围,即使本示例两个目标恰好都是 640×360。
| 状态 | 第一遍:离屏场景 | 第二遍:画布合成 |
|---|---|---|
| 绘制目标 | fbo |
null |
| 着色器 | sceneProgram |
screenProgram |
| 深度测试 | 开启并清除深度 | 关闭 |
| 纹理用途 | COLOR_ATTACHMENT0 写入 |
TEXTURE0 采样 |
如果将离屏尺寸降到 320×180,必须重新为颜色纹理调用 texImage2D()、为深度渲染缓冲调用 renderbufferStorage(),同时把第一遍视口设为 320×180。第二遍仍可按 640×360 显示,但图像会被放大。
出现黑屏或遮挡错误时如何检查
- 首先检查完整性。
FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT表示没有附件;遇到其他不完整状态,要核对纹理与渲染缓冲是否已经分配存储、附件格式是否可渲染,以及尺寸、采样数是否兼容。不要只检查createFramebuffer()是否返回对象。 - 检查输出目标和采样输入。 第二遍前确认已经执行
gl.bindFramebuffer(gl.FRAMEBUFFER, null),纹理绑定在TEXTURE0,uScene设为整数0。切勿在仍向某个 FBO 写入时,让片元着色器同时采样该 FBO 正在附着的颜色纹理;这会形成反馈回路。 - 检查深度和像素尺寸。 三维物体遮挡异常时,确认第一遍有深度附件,启用了
DEPTH_TEST,并在该遍清除了DEPTH_BUFFER_BIT;内容只占画布一角或被拉伸时,分别打印目标纹理尺寸与canvas.width/height,核对每遍的viewport。
实际项目可以把离屏颜色纹理继续交给模糊、描边或色调映射 Pass;只要后续 Pass 读取的是上一遍完成写入的纹理,并正确切换目标,就可以把这条最小链路扩展为多阶段渲染。