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 可以原样搬到其他着色器中复用。

html
<!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 调整过渡宽度。

把函数接口、坐标单位和边界条件保持一致后,同一组坐标、噪声与遮罩代码就能用于溶解、光晕、程序化材质等不同效果,修改配色和组合逻辑即可,不必复制基础算法。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装可复用的 GLSL 效果函数

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

登录哪都通