Web 图形与 3D / 系统课时
把离屏纹理送入全屏 Pass
把离屏纹理送入全屏 Pass
这一课将先把彩色画面绘制到离屏颜色纹理,再用覆盖整个画布的四边形读取纹理并执行灰度滤镜。最终在 WebGL2 画布看到后处理结果,同时掌握 Framebuffer、纹理单元和屏幕绘制之间的切换顺序。
学习目标
- 创建可采样的 RGBA8 颜色纹理并挂载到离屏 Framebuffer。
- 用四顶点全屏四边形将离屏画面传给片元着色器。
- 验证单次后处理结果,识别采样反馈和尺寸不匹配问题。
离屏绘制与全屏绘制的关系
普通绘制写入默认 Framebuffer,结果直接出现在 Canvas;离屏绘制先绑定自建 Framebuffer,把颜色写入它的 COLOR_ATTACHMENT0 纹理。后处理时先切回默认 Framebuffer,再把这张纹理绑定到纹理单元,让 sampler2D 读取像素。
这里总共执行两次绘制:第一次生成彩色源画面,第二次在四边形的每个片元采样源画面并输出灰度。两次绘制可以使用同一个四边形,但要切换片元着色器与绘制目标。

运行一遍完整的灰度滤镜
将下面内容保存为 pass.html,用支持 WebGL2 的浏览器打开。示例固定使用 640×360 画布;gl_VertexID 在顶点着色器中直接生成四个角,因此无需位置顶点缓冲区,但仍绑定一个 VAO。
<!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);,重新打开页面后应恢复彩色渐变和黄色圆形,这能确认采样的是离屏纹理,而非直接重画场景。
检查传递链路
验证时按绘制目标、纹理分配、采样绑定的次序定位,通常比直接改滤镜公式更有效。
- 画布全黑: 检查
gl.checkFramebufferStatus是否返回FRAMEBUFFER_COMPLETE,并确认第一次绘制发生在绑定fbo之后。 - 滤镜没有生效: 检查第二次绘制前是否调用
gl.bindFramebuffer(gl.FRAMEBUFFER, null),uScene是否设为0,以及colorTexture是否绑定在TEXTURE0。 - 画面被裁切: 分别检查两次
gl.viewport(0, 0, width, height);Viewport 需要对应当前绘制目标的实际像素大小。 - 浏览器报告 WebGL 错误: 不要在仍绑定当前颜色纹理作为绘制附件的 Framebuffer 中采样同一纹理,否则形成读写反馈,结果未定义。
换成真实三维场景时
保留颜色纹理、Framebuffer 和第二次绘制,把第一次的 sceneProgram 与四边形绘制替换成现有三维场景的绘制调用。若场景启用深度测试,还需给离屏 Framebuffer 配置深度附件;本示例只绘制二维画面,因此不需要深度缓冲。
窗口或 Canvas 像素尺寸改变时,重新用新尺寸分配颜色纹理,并更新相应深度附件和两次 Viewport;单纯调整 CSS 宽高不会自动重建离屏纹理。后处理只需读取颜色时,第二次绘制前应关闭不必要的深度测试和混合,避免已有渲染状态影响结果。
这里的 dot 是直接对采样 RGB 计算的展示用灰度近似。若将滤镜用于要求颜色精确的项目,应明确纹理的 sRGB 编码、线性空间处理与输出转换,不能把加权灰度误当成完整的颜色管理。