Web 图形与 3D / 系统课时

把离屏纹理送入全屏 Pass

把离屏纹理送入全屏 Pass

这一课将先把彩色画面绘制到离屏颜色纹理,再用覆盖整个画布的四边形读取纹理并执行灰度滤镜。最终在 WebGL2 画布看到后处理结果,同时掌握 Framebuffer、纹理单元和屏幕绘制之间的切换顺序。

学习目标

  • 创建可采样的 RGBA8 颜色纹理并挂载到离屏 Framebuffer。
  • 用四顶点全屏四边形将离屏画面传给片元着色器。
  • 验证单次后处理结果,识别采样反馈和尺寸不匹配问题。

离屏绘制与全屏绘制的关系

普通绘制写入默认 Framebuffer,结果直接出现在 Canvas;离屏绘制先绑定自建 Framebuffer,把颜色写入它的 COLOR_ATTACHMENT0 纹理。后处理时先切回默认 Framebuffer,再把这张纹理绑定到纹理单元,让 sampler2D 读取像素。

这里总共执行两次绘制:第一次生成彩色源画面,第二次在四边形的每个片元采样源画面并输出灰度。两次绘制可以使用同一个四边形,但要切换片元着色器与绘制目标。

离屏颜色纹理传入全屏滤镜的双 Pass 数据流

运行一遍完整的灰度滤镜

将下面内容保存为 pass.html,用支持 WebGL2 的浏览器打开。示例固定使用 640×360 画布;gl_VertexID 在顶点着色器中直接生成四个角,因此无需位置顶点缓冲区,但仍绑定一个 VAO。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGL2 单次后处理</title>
<canvas id="view" width="640" height="360"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前环境不支持 WebGL2");

const vertexSource = `#version 300 es
precision highp float;
out vec2 vUv;
void main() {
  // 四个顶点按三角形带顺序覆盖裁剪空间 [-1, 1]
  vec2 p = vec2((gl_VertexID & 1) == 1 ? 1.0 : -1.0,
                (gl_VertexID & 2) == 2 ? 1.0 : -1.0);
  vUv = p * 0.5 + 0.5;
  gl_Position = vec4(p, 0.0, 1.0);
}`;

const sceneSource = `#version 300 es
precision highp float;
in vec2 vUv;
uniform float uAspect;
out vec4 outColor;
void main() {
  vec3 base = vec3(vUv.x, vUv.y, 0.85);
  vec2 p = (vUv - 0.5) * vec2(uAspect, 1.0);
  float circle = 1.0 - smoothstep(0.18, 0.20, length(p));
  outColor = vec4(mix(base, vec3(1.0, 0.9, 0.2), circle), 1.0);
}`;

const filterSource = `#version 300 es
precision highp float;
in vec2 vUv;
uniform sampler2D uScene;
out vec4 outColor;
void main() {
  vec3 rgb = texture(uScene, vUv).rgb;
  // 加权得到用于显示的灰度值
  float gray = dot(rgb, vec3(0.2126, 0.7152, 0.0722));
  outColor = vec4(vec3(gray), 1.0);
}`;

function compile(type, source) {
  const shader = gl.createShader(type);
  gl.shaderSource(shader, source);
  gl.compileShader(shader);
  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS))
    throw new Error(gl.getShaderInfoLog(shader));
  return shader;
}

function makeProgram(fragmentSource) {
  const vs = compile(gl.VERTEX_SHADER, vertexSource);
  const fs = compile(gl.FRAGMENT_SHADER, fragmentSource);
  const program = gl.createProgram();
  gl.attachShader(program, vs);
  gl.attachShader(program, fs);
  gl.linkProgram(program);
  if (!gl.getProgramParameter(program, gl.LINK_STATUS))
    throw new Error(gl.getProgramInfoLog(program));
  gl.deleteShader(vs);
  gl.deleteShader(fs);
  return program;
}

const sceneProgram = makeProgram(sceneSource);
const filterProgram = makeProgram(filterSource);
gl.bindVertexArray(gl.createVertexArray());

const width = gl.drawingBufferWidth;
const height = gl.drawingBufferHeight;
const colorTexture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, colorTexture);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, width, height,
              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);

const fbo = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, fbo);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
                        gl.TEXTURE_2D, colorTexture, 0);
if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE)
  throw new Error("离屏 Framebuffer 不完整");
gl.bindTexture(gl.TEXTURE_2D, null);

// 第一次绘制:写入离屏颜色纹理,不采样它
gl.viewport(0, 0, width, height);
gl.useProgram(sceneProgram);
gl.uniform1f(gl.getUniformLocation(sceneProgram, "uAspect"), width / height);
gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);

// 第二次绘制:解绑离屏目标后采样纹理,写入 Canvas
gl.bindFramebuffer(gl.FRAMEBUFFER, null);
gl.viewport(0, 0, width, height);
gl.useProgram(filterProgram);
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, colorTexture);
gl.uniform1i(gl.getUniformLocation(filterProgram, "uScene"), 0);
gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
</script>
</html>

预期结果: 页面出现 640×360 的灰度渐变画面,中间有明显较亮的圆形;不再显示原始彩色。如果把滤镜最后一行临时改成 outColor = vec4(rgb, 1.0);,重新打开页面后应恢复彩色渐变和黄色圆形,这能确认采样的是离屏纹理,而非直接重画场景。

检查传递链路

验证时按绘制目标、纹理分配、采样绑定的次序定位,通常比直接改滤镜公式更有效。

  1. 画布全黑: 检查 gl.checkFramebufferStatus 是否返回 FRAMEBUFFER_COMPLETE,并确认第一次绘制发生在绑定 fbo 之后。
  2. 滤镜没有生效: 检查第二次绘制前是否调用 gl.bindFramebuffer(gl.FRAMEBUFFER, null),uScene 是否设为 0,以及 colorTexture 是否绑定在 TEXTURE0。
  3. 画面被裁切: 分别检查两次 gl.viewport(0, 0, width, height);Viewport 需要对应当前绘制目标的实际像素大小。
  4. 浏览器报告 WebGL 错误: 不要在仍绑定当前颜色纹理作为绘制附件的 Framebuffer 中采样同一纹理,否则形成读写反馈,结果未定义。

换成真实三维场景时

保留颜色纹理、Framebuffer 和第二次绘制,把第一次的 sceneProgram 与四边形绘制替换成现有三维场景的绘制调用。若场景启用深度测试,还需给离屏 Framebuffer 配置深度附件;本示例只绘制二维画面,因此不需要深度缓冲。

窗口或 Canvas 像素尺寸改变时,重新用新尺寸分配颜色纹理,并更新相应深度附件和两次 Viewport;单纯调整 CSS 宽高不会自动重建离屏纹理。后处理只需读取颜色时,第二次绘制前应关闭不必要的深度测试和混合,避免已有渲染状态影响结果。

这里的 dot 是直接对采样 RGB 计算的展示用灰度近似。若将滤镜用于要求颜色精确的项目,应明确纹理的 sRGB 编码、线性空间处理与输出转换,不能把加权灰度误当成完整的颜色管理。

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

目录与阅读设置

阅读设置

17

记录一个想法

把离屏纹理送入全屏 Pass

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

登录哪都通