Web 图形与 3D / 系统课时
封装可复用的 GLSL 效果函数
封装可复用的 GLSL 效果函数
多个片元着色器都要使用噪声、遮罩和坐标校正时,复制表达式会让参数和修复散落在各处。这里把三类计算拆成可组合的 GLSL 函数,使用 JavaScript 组织源码片段,并在 WebGL2 中运行一个动态圆形噪声效果。
学习目标
- 为坐标、噪声和遮罩函数定义明确的参数、返回值与适用范围。
- 在 WebGL2 中组合 GLSL ES 3.00 源码片段并编译运行。
- 通过改变效果参数和画布尺寸验证函数的复用性。
为函数约定输入和输出
拆分的单位应是计算规则,而不是某一种材质的完整颜色。这样同一个遮罩既能裁剪噪声,也能裁剪渐变或纹理。建议先确定以下接口:
| 函数 | 输入 | 返回值及约定 |
|---|---|---|
centeredUV(pixel, size) |
像素坐标、画布像素尺寸 | 屏幕中心为 (0, 0);以画布高度为单位,避免宽屏时圆形变椭圆 |
valueNoise(p) |
连续二维采样坐标 | 0~1 的平滑值噪声;采样坐标乘 7.0 会增加细节频率 |
circleMask(p, center, radius, feather) |
同一坐标空间内的点、圆心、半径与过渡半宽 | 圆内接近 1、圆外接近 0,要求 radius > feather > 0 |
这三个函数都不直接读取 uniform,因此同样的输入会得到同样的结果。时间和分辨率由调用方显式传入;颜色、透明度和混合方式放在主效果中,避免让一个“噪声函数”暗中决定最终配色。
按数据依赖组合模块
WebGL2 的 GLSL ES 3.00 没有原生的 #include 文件机制。可以先在 JavaScript 中保存 coords、noise、mask 等源码字符串,再拼接到同一份片元着色器。拼接后的 #version 300 es 必须位于源码起始位置;同名函数只能定义一次。

图中的依赖关系也决定了源码的组合顺序:公共函数先声明,主效果最后调用。真实项目可把这些字符串迁移到独立 .glsl 文件并交给构建工具加载,但送入 gl.shaderSource 的始终应是一份完整且合法的 GLSL 源码。
运行可组合的动态效果
把下面的内容保存为 index.html,使用支持 WebGL2 的浏览器直接打开。示例用全屏三角形绘制画布,不依赖 Three.js 或外部图片;coordChunk、noiseChunk、maskChunk 可以原样搬到其他着色器中复用。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>GLSL 函数组合</title>
<canvas width="800" height="450"
style="width:min(96vw,800px);height:auto;display:block"></canvas>
<script>
const canvas = document.querySelector('canvas');
const gl = canvas.getContext('webgl2');
if (!gl) throw new Error('当前浏览器或环境不支持 WebGL2');
const vertexSource = `#version 300 es
void main() {
// 三个顶点覆盖整个裁剪空间,不需要顶点缓冲区。
vec2 p = vec2(gl_VertexID == 1 ? 2.0 : 0.0,
gl_VertexID == 2 ? 2.0 : 0.0);
gl_Position = vec4(p * 2.0 - 1.0, 0.0, 1.0);
}`;
const coordChunk = `
vec2 centeredUV(vec2 pixel, vec2 size) {
return (pixel - 0.5 * size) / size.y;
}`;
const noiseChunk = `
float hash21(vec2 p) {
p = fract(p * vec2(123.34, 345.45));
p += dot(p, p + 34.345);
return fract(p.x * p.y);
}
float valueNoise(vec2 p) {
vec2 i = floor(p);
vec2 f = fract(p);
f = f * f * (3.0 - 2.0 * f);
float a = hash21(i);
float b = hash21(i + vec2(1.0, 0.0));
float c = hash21(i + vec2(0.0, 1.0));
float d = hash21(i + vec2(1.0, 1.0));
return mix(mix(a, b, f.x), mix(c, d, f.x), f.y);
}`;
const maskChunk = `
float circleMask(vec2 p, vec2 center, float radius, float feather) {
float d = length(p - center);
return 1.0 - smoothstep(radius - feather, radius + feather, d);
}`;
const effectChunk = `
uniform vec2 uResolution;
uniform float uTime;
out vec4 outColor;
void main() {
vec2 uv = centeredUV(gl_FragCoord.xy, uResolution);
float n = valueNoise(uv * 7.0 + vec2(uTime * 0.25, 0.0));
// 过渡宽度约为三个屏幕像素。
float m = circleMask(uv, vec2(0.0), 0.32, 1.5 / uResolution.y);
vec3 ink = mix(vec3(0.05, 0.12, 0.18),
vec3(0.16, 0.85, 0.68), n);
outColor = vec4(mix(vec3(0.02, 0.04, 0.07), ink, m), 1.0);
}`;
// 版本声明必须在最前,函数定义随后,main 最后。
const fragmentSource = `#version 300 es
precision highp float;
${coordChunk}
${noiseChunk}
${maskChunk}
${effectChunk}`;
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 program = gl.createProgram();
gl.attachShader(program, compile(gl.VERTEX_SHADER, vertexSource));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragmentSource));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
gl.bindVertexArray(gl.createVertexArray());
const sizeLoc = gl.getUniformLocation(program, 'uResolution');
const timeLoc = gl.getUniformLocation(program, 'uTime');
function frame(ms) {
const scale = Math.min(window.devicePixelRatio || 1, 2);
const w = Math.max(1, Math.round(canvas.clientWidth * scale));
const h = Math.max(1, Math.round(canvas.clientHeight * scale));
if (canvas.width !== w || canvas.height !== h) {
canvas.width = w;
canvas.height = h;
}
gl.viewport(0, 0, canvas.width, canvas.height);
gl.uniform2f(sizeLoc, canvas.width, canvas.height);
gl.uniform1f(timeLoc, ms * 0.001);
gl.drawArrays(gl.TRIANGLES, 0, 3);
requestAnimationFrame(frame);
}
requestAnimationFrame(frame);
</script>
</html>预期结果: 浏览器出现深色画布,中央有边缘平滑的圆形,圆内的蓝绿色噪声不断缓慢移动;圆在宽窄不同的窗口里保持正圆,控制台没有着色器编译或链接错误。圆的直径约为画布高度的 0.64 倍。
验证接口边界和复用效果
先只修改 effectChunk,不要改动三个工具函数。把噪声采样中的 uv * 7.0 改为 uv * 14.0,预期圆内花纹更细密;再把 circleMask 的圆心设为 vec2(0.25, 0.0),圆会向右移动约四分之一画布高度。若改变画布宽度后圆被拉伸,应检查是否误将坐标分别除以 uResolution.x 和 uResolution.y。
circleMask 的 feather 必须大于零,且小于 radius;若给 smoothstep 传入相同或倒置的两条边界,结果未定义。像素边缘宽度在这里用 1.5 / uResolution.y 表示,因此高分辨率下仍接近三像素。需要抗锯齿更细致时,可依据目标坐标的 fwidth 调整过渡宽度。
把函数接口、坐标单位和边界条件保持一致后,同一组坐标、噪声与遮罩代码就能用于溶解、光晕、程序化材质等不同效果,修改配色和组合逻辑即可,不必复制基础算法。