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,发现配置错误就停止绘制。

html
<!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 输出:

text
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 显示,但图像会被放大。

出现黑屏或遮挡错误时如何检查

  1. 首先检查完整性。 FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT 表示没有附件;遇到其他不完整状态,要核对纹理与渲染缓冲是否已经分配存储、附件格式是否可渲染,以及尺寸、采样数是否兼容。不要只检查 createFramebuffer() 是否返回对象。
  2. 检查输出目标和采样输入。 第二遍前确认已经执行 gl.bindFramebuffer(gl.FRAMEBUFFER, null),纹理绑定在 TEXTURE0,uScene 设为整数 0。切勿在仍向某个 FBO 写入时,让片元着色器同时采样该 FBO 正在附着的颜色纹理;这会形成反馈回路。
  3. 检查深度和像素尺寸。 三维物体遮挡异常时,确认第一遍有深度附件,启用了 DEPTH_TEST,并在该遍清除了 DEPTH_BUFFER_BIT;内容只占画布一角或被拉伸时,分别打印目标纹理尺寸与 canvas.width/height,核对每遍的 viewport。

实际项目可以把离屏颜色纹理继续交给模糊、描边或色调映射 Pass;只要后续 Pass 读取的是上一遍完成写入的纹理,并正确切换目标,就可以把这条最小链路扩展为多阶段渲染。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

将场景画面写入帧缓冲纹理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通