Web 图形与 3D / 系统课时
用全屏着色器添加后处理效果
用全屏着色器添加后处理效果
把场景先绘制到离屏颜色纹理,再通过全屏三角形把它送进片元着色器,就能一次性给整幅画面添加灰度效果。完成后将得到一个可直接打开的 WebGL 2 页面,并能确认两次绘制分别写入哪个目标。
学习目标
- 说明离屏帧缓冲、颜色纹理、后处理程序和默认帧缓冲之间的关系。
- 使用
gl_VertexID绘制全屏三角形,采样纹理并计算灰度。 - 验证两次绘制的目标、纹理单元和尺寸设置,避开读写反馈回路。
先把场景画到纹理,再画到屏幕
后处理不是直接修改已显示在画布上的像素,而是使用两次绘制。第一遍绑定自建的 Framebuffer,把场景颜色写入其 COLOR_ATTACHMENT0 所连接的 TEXTURE_2D;第二遍绑定 null(默认帧缓冲),用全屏三角形读取那张纹理并输出到画布。

两遍之间保留颜色纹理内容,不需要把像素读回 JavaScript。尤其不能在第二遍仍绑定原 FBO、同时采样它所附着的颜色纹理;这种读写反馈回路的结果未定义。
用一个 HTML 文件跑通灰度效果
把下面内容保存为 postprocess.html,在支持 WebGL 2 的桌面浏览器中打开。为突出后处理,第一遍只绘制一个带顶点渐变色的三角形;接入真实场景时,把这部分替换成已有的网格绘制即可。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGL 2 灰度后处理</title>
<canvas id="view" width="640" height="360"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2", { alpha: false });
if (!gl) throw new Error("当前浏览器不支持 WebGL 2");
// 编译和链接两个独立的绘制程序,便于定位着色器错误。
function makeProgram(vertexSource, fragmentSource) {
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;
}
const vertex = compile(gl.VERTEX_SHADER, vertexSource);
const fragment = compile(gl.FRAGMENT_SHADER, fragmentSource);
const program = gl.createProgram();
gl.attachShader(program, vertex);
gl.attachShader(program, fragment);
gl.linkProgram(program);
gl.deleteShader(vertex);
gl.deleteShader(fragment);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
return program;
}
const sceneProgram = makeProgram(`#version 300 es
const vec2 points[3] = vec2[3](
vec2(-0.8, -0.75), vec2(0.8, -0.75), vec2(0.0, 0.8)
);
const vec3 colors[3] = vec3[3](
vec3(1.0, 0.2, 0.15), vec3(0.15, 0.9, 0.25), vec3(0.15, 0.3, 1.0)
);
out vec3 vColor;
void main() {
gl_Position = vec4(points[gl_VertexID], 0.0, 1.0);
vColor = colors[gl_VertexID];
}`, `#version 300 es
precision highp float;
in vec3 vColor;
out vec4 fragColor;
void main() {
fragColor = vec4(vColor, 1.0);
}`);
const postProgram = makeProgram(`#version 300 es
out vec2 vUV;
void main() {
// 一个超出裁剪范围的大三角形,覆盖全部视口。
const vec2 points[3] = vec2[3](
vec2(-1.0, -1.0), vec2(3.0, -1.0), vec2(-1.0, 3.0)
);
vec2 p = points[gl_VertexID];
vUV = (p + 1.0) * 0.5;
gl_Position = vec4(p, 0.0, 1.0);
}`, `#version 300 es
precision highp float;
in vec2 vUV;
uniform sampler2D uScene;
out vec4 fragColor;
void main() {
vec4 source = texture(uScene, vUV);
float gray = dot(source.rgb, vec3(0.2126, 0.7152, 0.0722));
fragColor = vec4(vec3(gray), source.a);
}`);
// 离屏目标:一张可渲染、也可供第二遍采样的二维颜色纹理。
const sceneTexture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, sceneTexture);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8,
canvas.width, canvas.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);
gl.bindTexture(gl.TEXTURE_2D, null);
const offscreen = gl.createFramebuffer();
gl.bindFramebuffer(gl.FRAMEBUFFER, offscreen);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
gl.TEXTURE_2D, sceneTexture, 0);
if (gl.checkFramebufferStatus(gl.FRAMEBUFFER) !== gl.FRAMEBUFFER_COMPLETE) {
throw new Error("离屏帧缓冲不完整");
}
// 这里没有顶点缓冲;两个顶点着色器均根据 gl_VertexID 生成顶点。
gl.bindVertexArray(gl.createVertexArray());
// 第一遍:彩色场景写入离屏颜色纹理。
gl.bindFramebuffer(gl.FRAMEBUFFER, offscreen);
gl.viewport(0, 0, canvas.width, canvas.height);
gl.clearColor(0.08, 0.12, 0.23, 1.0);
gl.clear(gl.COLOR_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.useProgram(postProgram);
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, sceneTexture);
gl.uniform1i(gl.getUniformLocation(postProgram, "uScene"), 0);
gl.drawArrays(gl.TRIANGLES, 0, 3);
console.log("离屏缓冲完整,后处理绘制完成");
</script>
</html>预期结果:页面出现 640×360 画布,深灰背景中有灰度渐变三角形,原本的红、绿、蓝色不再出现。开发者工具控制台输出:
离屏缓冲完整,后处理绘制完成全屏三角形为什么只需三个顶点
顶点着色器写入的裁剪空间二维坐标为 (-1,-1)、(3,-1)、(-1,3)。视口的可见范围是横纵坐标各 [-1,1];超出范围的三角形部分会被裁剪,留下覆盖整个视口的区域。这样无需 VBO,也不会像两个拼接三角形那样在屏幕内部形成公共对角线。

vUV = (p + 1.0) * 0.5 把可见范围映射为 0~1 的纹理坐标。画布与离屏纹理同为 640×360,并分别设置两次 gl.viewport,因此可以按相同位置逐像素取样;本例从 WebGL 纹理直接采样,不需要额外翻转 V 轴。
验证绑定与处理真实场景
| 检查点 | 正确做法 | 出错时的表现 |
|---|---|---|
| 离屏完整性 | checkFramebufferStatus 返回 FRAMEBUFFER_COMPLETE |
无法可靠写入颜色纹理 |
| 第二遍的绘制目标 | bindFramebuffer(gl.FRAMEBUFFER, null) |
画布仍是旧画面或空白 |
| 采样单元 | activeTexture(TEXTURE0) 后绑定纹理,uniform1i(uScene, 0) |
采样错误纹理或显示黑色 |
| 像素尺寸 | 纹理分配、两次 viewport 与 canvas.width/height 相匹配 |
拉伸、截断或分辨率不符合预期 |
验证两次绘制是否真正分离,可以暂时把后处理片元着色器中的 vec3(gray) 改为 source.rgb 并刷新页面:画面应恢复彩色,而离屏场景绘制代码无需改动。
如果画布绘图缓冲尺寸发生变化,必须重新用 texImage2D 分配离屏纹理,并更新两个 viewport;只改 CSS 宽高不能改变绘图缓冲分辨率。接入启用了深度测试的三维场景时,还要为离屏 FBO 添加深度附件并在第一遍清除深度缓冲,否则遮挡关系可能错误。第二遍始终采样第一遍完成的颜色纹理,并输出到另一个绘制目标。