Web 图形与 3D / 系统课时
用时间参数驱动周期动画
用时间参数驱动周期动画
本课把浏览器逐帧提供的时间转换为 Shader 的 uTime,让同一幅画面同时出现平滑的亮度呼吸和不断向右移动的青绿色光带。完成后,你会得到一个无需外部库、可以直接在支持 WebGL2 的浏览器中运行的动态材质示例。
学习目标
- 理解时间 uniform 的单位、更新方式及其与帧率的关系。
- 使用
sin制作平滑呼吸动画,使用fract制作循环流动效果。 - 完成 WebGL2 动画示例,并通过修改频率、速度和条纹密度验证效果。
将时间传入片元着色器
GLSL 着色器不会自动获得浏览器的运行时间,需要 JavaScript 在每帧绘制前主动更新。片元着色器声明 uniform float uTime;,JavaScript 使用 gl.getUniformLocation 获取位置,再通过 gl.uniform1f 写入时间值。同一帧中的所有片元读取相同的 uTime,但可以结合各自的屏幕坐标产生不同颜色。
requestAnimationFrame 的回调参数是毫秒时间戳,而动画表达式通常以秒为单位。以首次回调时间为起点,使用 (now - start) / 1000 得到已经经过的秒数。例如经过 2500 毫秒时,传入 Shader 的 uTime 应为 2.5。
时间决定动画所处的相位,而不是直接决定颜色。只要每帧传入新的时间值,相同的数学表达式就会得到不断变化的结果。使用实际经过时间计算相位,能避免把动画速度绑定到固定的 60 FPS:即使设备只运行在 30 FPS,动画仍以相同的物理时间推进,只是画面更新次数更少。
用 sin 和 fract 构造两种周期变化
sin 接收弧度并返回 -1 到 1 的数值。为了控制颜色亮度,可以把输出映射到 0 到 1:0.5 + 0.5 * sin(uTime * 2.0)。其中 2.0 是角频率,单位为弧度每秒,因此一次完整呼吸约需 2π / 2 = 3.14 秒。结果平滑变化,适合发光强度、透明度、缩放幅度等连续动画。
fract(x) 返回 x - floor(x),结果位于 0 到 1 之间且不包含 1。表达式 fract(vUv.x * 6.0 - uTime * 0.7) 把横向 UV 坐标重复划分成 6 个周期,同时让每个周期的相位随时间变化。时间项前的负号使条纹向右移动;改为正号则向左移动。
直接显示 fract 的结果会在每个周期边界发生突变,因此这里使用两段 smoothstep 构造具有柔和边缘的光带。第一段使亮度从 0 平滑升高,第二段使亮度平滑降低,令相位首尾都回到暗色,从而减少循环接缝处的视觉跳变。

实现完整的 WebGL2 时间动画
创建 index.html,粘贴以下完整代码,保存后使用支持 WebGL2 的 Chrome 或 Edge 浏览器打开。示例用 gl_VertexID 生成覆盖整个视口的三角形,无需单独上传顶点缓冲数据;顶点着色器输出的 vUv 在三角形内部插值,为片元着色器提供屏幕坐标。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>GLSL 时间动画</title>
<style>
html, body { margin: 0; width: 100%; height: 100%; }
canvas { display: block; width: 100vw; height: 100vh; }
</style>
</head>
<body>
<canvas id="view"></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() {
// 三个内置顶点编号构造覆盖整个视口的大三角形
vec2 p = vec2(gl_VertexID == 1 ? 3.0 : -1.0,
gl_VertexID == 2 ? 3.0 : -1.0);
vUv = p * 0.5 + 0.5;
gl_Position = vec4(p, 0.0, 1.0);
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec2 vUv;
uniform float uTime;
out vec4 outColor;
void main() {
// 正弦波映射到0到1,形成连续的呼吸亮度
float breathe = 0.5 + 0.5 * sin(uTime * 2.0);
// 负时间项使重复条纹沿屏幕水平方向向右移动
float phase = fract(vUv.x * 6.0 - uTime * 0.7);
float stripe = smoothstep(0.0, 0.08, phase) *
(1.0 - smoothstep(0.2, 0.32, phase));
// 两种动画叠加后,颜色混合系数始终在0到1内
float amount = 0.12 + 0.38 * breathe + 0.50 * stripe;
vec3 base = vec3(0.02, 0.07, 0.12);
vec3 glow = vec3(0.08, 0.80, 0.72);
outColor = vec4(mix(base, glow, amount), 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;
}
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 timeLocation = gl.getUniformLocation(program, 'uTime');
let start = null;
function draw(now) {
if (start === null) start = now;
// 根据画布实际像素尺寸更新视口,避免拉伸和模糊
const ratio = Math.min(window.devicePixelRatio || 1, 2);
const width = Math.max(1, Math.round(canvas.clientWidth * ratio));
const height = Math.max(1, Math.round(canvas.clientHeight * ratio));
if (canvas.width !== width || canvas.height !== height) {
canvas.width = width;
canvas.height = height;
gl.viewport(0, 0, width, height);
}
// 毫秒转换为秒,每帧更新uniform后再发起绘制
gl.uniform1f(timeLocation, (now - start) / 1000);
gl.drawArrays(gl.TRIANGLES, 0, 3);
requestAnimationFrame(draw);
}
requestAnimationFrame(draw);
</script>
</body>
</html>预期结果:浏览器窗口被深蓝色填满,画面上约有 6 条柔边青绿色竖向光带持续向右移动,整体亮度周期性增强和减弱。完整呼吸周期约为 3.14 秒,条纹图案约每 1.43 秒重复一次;动画能够持续运行,调整浏览器窗口尺寸后仍覆盖整个视口。
示例的 amount 是颜色混合权重,不是最终亮度值。呼吸分量的贡献范围为 0 到 0.38,条纹分量的贡献范围为 0 到 0.50,再加上 0.12 的基础权重,总范围为 0.12 到 1.00,因此可以直接交给 mix,不需要额外裁剪。这里的两个动画通过同一时间参数更新,却分别控制全局明暗与局部空间图案。
调整速度并验证循环行为
修改片元着色器的以下参数,然后刷新页面,即可观察时间频率与空间密度的区别。表中周期按连续时间计算,不依赖实际刷新率。
| 调整位置 | 原始值 | 修改值 | 预期效果 |
|---|---|---|---|
sin(uTime * 2.0) |
2.0 |
4.0 |
呼吸周期从约3.14秒缩短为1.57秒 |
vUv.x * 6.0 |
6.0 |
10.0 |
横向条纹数量从6组变为10组 |
uTime * 0.7 |
0.7 |
1.4 |
条纹相位推进速度加倍,重复周期缩短到约0.71秒 |
0.50 * stripe |
0.50 |
0.0 |
移除流动条纹,仅保留全屏呼吸效果 |
如果画面完全不动,先在浏览器开发者工具的 Console 中检查错误,再确认 requestAnimationFrame(draw) 持续执行、gl.useProgram(program) 已调用,并且 gl.uniform1f 位于每次绘制之前。若画面为空白,检查 WebGL2 是否可用以及顶点、片元着色器是否编译和链接成功;示例会把相关错误输出到控制台。
还可以将片元着色器中的 uTime 暂时替换为常量 0.0 并刷新页面:颜色和条纹应固定不动。恢复 uTime 后动画应继续,这能快速区分时间传递问题和颜色计算问题。实际项目中优先根据经过的时间计算相位,不要简单地每帧累加固定的 0.016 秒,否则在不同帧率下会产生明显的速度偏差。