Web 图形与 3D / 系统课时
用顶点位移制作动态波浪网格
用顶点位移制作动态波浪网格
把静止的细分平面变成持续起伏的三维波浪,并用光照显示波峰与波谷。完成后,你会得到一个无需第三方库、可直接在浏览器打开的 WebGL2 页面,还能用振幅、方向和速度控制动画。
学习目标
- 用时间和顶点水平坐标计算正弦波高度。
- 生成足够密集的三角网格,在顶点着色器中修改位置。
- 根据波面斜率更新法线,并检查动画与光照效果。
定义位移与细分
令平面位于 XZ 轴,高度沿 Y 轴变化。每个顶点原本为 (x, 0, z),在顶点着色器中将 Y 改为:
其中,方向向量 (d_x,d_z) 必须归一化。取振幅 A=0.16、空间角频率 k=8 弧度/单位、时间角频率 ω=2 弧度/秒,波长约为 0.785 单位,波峰沿方向向量每秒前进 0.25 单位。时间取自 requestAnimationFrame 的毫秒时间戳,转换成秒后上传 uTime。
使用边长 2.4 单位的平面,沿 X、Z 各切成 100 段,可得到 101×101=10201 个顶点和 20000 个三角形。顶点只改 Y 坐标,XZ 坐标始终保持不变;若改成 10×10 段,波峰会出现明显折线。

实现完整页面
新建 index.html,写入以下完整代码,然后使用支持 WebGL2 的浏览器打开。页面生成顶点与三角形索引,顶点着色器执行波浪位移,片元着色器根据更新后的法线计算漫反射亮度。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>WebGL2 顶点波浪</title>
</head>
<body style="margin:0">
<canvas id="scene" style="display:block;width:100vw;height:100vh"></canvas>
<script>
const canvas = document.querySelector('#scene');
const gl = canvas.getContext('webgl2', { antialias: true });
if (!gl) throw new Error('当前浏览器不支持 WebGL2');
const vertexSource = `#version 300 es
precision highp float;
layout(location = 0) in vec2 aXZ;
uniform float uTime;
uniform float uAspect;
out vec3 vNormal;
void main() {
vec2 dir = normalize(vec2(1.0, 0.35));
float amplitude = 0.16;
float k = 8.0;
float phase = k * dot(aXZ, dir) - 2.0 * uTime;
float height = amplitude * sin(phase);
vec3 position = vec3(aXZ.x, height, aXZ.y);
// 从高度对 X、Z 的偏导数重建波面法线
vec2 slope = amplitude * k * cos(phase) * dir;
vNormal = normalize(vec3(-slope.x, 1.0, -slope.y));
// 倾斜观察平面,再进行透视投影
float angle = -0.95;
mat3 tilt = mat3(
1.0, 0.0, 0.0,
0.0, cos(angle), sin(angle),
0.0, -sin(angle), cos(angle)
);
vec3 viewPos = tilt * position + vec3(0.0, 0.0, -3.2);
float f = 1.0 / tan(radians(45.0) * 0.5);
float clipZ = -10.1 / 9.9 * viewPos.z - 2.0 / 9.9;
gl_Position = vec4(
f * viewPos.x / uAspect, f * viewPos.y, clipZ, -viewPos.z
);
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec3 vNormal;
out vec4 outColor;
void main() {
vec3 lightDir = normalize(vec3(0.3, 1.0, 0.5));
float diffuse = max(dot(normalize(vNormal), lightDir), 0.0);
vec3 color = vec3(0.05, 0.58, 0.64) * (0.35 + 0.65 * diffuse);
outColor = vec4(color, 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));
}
const segments = 100;
const vertices = [];
const indices = [];
for (let z = 0; z <= segments; z++) {
for (let x = 0; x <= segments; x++) {
vertices.push(2.4 * (x / segments - 0.5),
2.4 * (z / segments - 0.5));
}
}
for (let z = 0; z < segments; z++) {
for (let x = 0; x < segments; x++) {
const a = z * (segments + 1) + x;
const b = a + 1;
const c = a + segments + 1;
const d = c + 1;
indices.push(a, c, b, b, c, d);
}
}
// 绑定顶点属性与元素索引,之后每帧复用网格
const vao = gl.createVertexArray();
gl.bindVertexArray(vao);
const vbo = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(vertices), gl.STATIC_DRAW);
gl.enableVertexAttribArray(0);
gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
const ebo = gl.createBuffer();
gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, ebo);
gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, new Uint16Array(indices), gl.STATIC_DRAW);
gl.bindVertexArray(null);
const timeLoc = gl.getUniformLocation(program, 'uTime');
const aspectLoc = gl.getUniformLocation(program, 'uAspect');
gl.enable(gl.DEPTH_TEST);
gl.clearColor(0.97, 0.98, 0.99, 1.0);
function render(milliseconds) {
const dpr = Math.min(window.devicePixelRatio || 1, 2);
const width = Math.max(1, Math.round(canvas.clientWidth * dpr));
const height = Math.max(1, Math.round(canvas.clientHeight * dpr));
if (canvas.width !== width || canvas.height !== height) {
canvas.width = width;
canvas.height = height;
}
gl.viewport(0, 0, width, height);
gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
gl.useProgram(program);
// 传入秒数,网格本身无需逐帧重新上传
gl.uniform1f(timeLoc, milliseconds * 0.001);
gl.uniform1f(aspectLoc, width / height);
gl.bindVertexArray(vao);
gl.drawElements(gl.TRIANGLES, indices.length, gl.UNSIGNED_SHORT, 0);
requestAnimationFrame(render);
}
requestAnimationFrame(render);
</script>
</body>
</html>预期结果:页面显示一块倾斜观察的青绿色三维波面,波峰随时间持续平移;波峰和波谷附近的明暗随表面倾角变化。背景为浅灰白色,调整浏览器窗口大小时图形比例保持正常。本示例以页面可见效果为验收,不依赖固定的控制台输出。
验证动画与调参
先将顶点着色器的 amplitude 改为 0.0,刷新后应看到平面;恢复 0.16 后,波面重新出现。把 2.0 * uTime 改成 0.0 * uTime,应冻结当前波形,借此确认形变来自时间而不是 CPU 更新网格。
| 参数 | 当前值 | 改动后的可见结果 |
|---|---|---|
amplitude |
0.16 |
调到 0.30,波峰更高 |
k |
8.0 |
调到 4.0,波峰间距增大一倍 |
dir |
(1.0, 0.35) 归一化 |
改成 (0.0, 1.0),沿 Z 方向传播 |
segments |
100 |
改成 10,波面轮廓明显变粗糙 |
如果完全黑屏,先检查浏览器开发者工具 Console 中的编译或链接错误,并确认 getContext('webgl2') 成功;若能看到平面却没有动画,检查 requestAnimationFrame 是否执行,以及 uTime 是否持续变化。
法线与性能边界
正弦位移会改变表面倾角。如果仍使用平面的法线 (0,1,0),所有三角形接收到近似相同的漫反射亮度,波面就会显得扁平。代码使用斜率 A × k × cos(phase) × dir,构造 (-∂h/∂x,1,-∂h/∂z) 并归一化;法线与光照方向都处于网格局部空间,计算才一致。
当前网格只上传一次,之后每帧只更新 uTime 与 uAspect,不会在 JavaScript 中逐顶点重建数组。segments=100 的最大顶点索引为 10200,可以使用 Uint16Array;如果细分超过 255×255 段,应改为 Uint32Array,绘制类型同步改为 gl.UNSIGNED_INT。当振幅与频率同时增大时,也要提高细分密度,避免顶点采样不足造成尖折与闪烁。