Web 图形与 3D / 系统课时
通过 UV 偏移制作波纹扭曲
通过 UV 偏移制作波纹扭曲
本课用一张程序生成的棋盘纹理制作向外扩散的水波扭曲。你将从当前片元到波源的距离计算周期性偏移,再用偏移后的 UV 采样原纹理,得到持续运动、中心逐渐衰减的波纹,并学会验证边界与参数是否正确。
学习目标
- 分清片元原始 UV 与纹理实际采样 UV,理解径向波纹为何只扭曲图像。
- 使用正弦相位、径向方向和指数衰减控制波纹密度、速度与强度。
- 运行一个无需外部图片的 WebGL2 示例,并检查纹理方向与采样边界。
用径向距离改变采样位置
普通纹理采样直接取 texture(uTexture, vUv);波纹扭曲则先计算新坐标 p',再读取 texture(uTexture, p')。被移动的是取色位置,画布上的片元和三角形并没有移动。
设当前 UV 为 p、波源中心为 c、半径为 r,一个带衰减的向外传播波纹可写成:
这里 t 是运行秒数。方向向量由 p-c 归一化得到;波源处用 max(r, 0.0001) 避免除以零。60r-5t 的相位随时间变化,使同一波峰沿半径增大的方向移动。
| 参数 | 本例取值 | 改动后的效果 |
|---|---|---|
| 最大偏移幅度 | 0.02 UV |
越大,格线弯曲越明显 |
| 径向频率 | 60.0 |
越大,相邻波纹越密 |
| 时间角速度 | 5.0 |
越大,波纹向外移动越快 |
| 衰减系数 | 4.0 |
越大,影响范围越靠近中心 |

运行完整的 WebGL2 页面
新建 ripple.html,粘贴下面的完整代码并用支持 WebGL2 的现代浏览器打开。程序用离屏 Canvas 绘制 512×512 棋盘并上传为纹理,不依赖外部图片、服务器或第三方库;显示画布也设为正方形,避免把圆形波纹压成椭圆。
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>UV 径向波纹</title>
<canvas id="view" width="640" height="640"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前环境不支持 WebGL2");
const vs = `#version 300 es
in vec2 aPosition;
out vec2 vUv;
void main() {
vUv = aPosition * 0.5 + 0.5;
gl_Position = vec4(aPosition, 0.0, 1.0);
}`;
const fs = `#version 300 es
precision highp float;
in vec2 vUv;
uniform sampler2D uTexture;
uniform float uTime;
uniform vec2 uCenter;
out vec4 outColor;
void main() {
vec2 delta = vUv - uCenter;
float r = length(delta);
// 用安全分母取得径向方向,波心处不会除以零
vec2 dir = delta / max(r, 0.0001);
float phase = 60.0 * r - 5.0 * uTime;
float offset = 0.02 * sin(phase) * exp(-4.0 * r);
// 只改变取色坐标,不修改屏幕片元的位置
vec2 sampleUv = clamp(vUv + dir * offset, vec2(0.0), vec2(1.0));
outColor = texture(uTexture, sampleUv);
}`;
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, vs));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fs));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
// 一个全屏三角形覆盖视口,vUv 在可见区域内为 0~1
const vao = gl.createVertexArray();
gl.bindVertexArray(vao);
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER,
new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);
const position = gl.getAttribLocation(program, "aPosition");
gl.enableVertexAttribArray(position);
gl.vertexAttribPointer(position, 2, gl.FLOAT, false, 0, 0);
// 棋盘图案用于观察格线如何被 UV 波纹推弯
const sourceCanvas = document.createElement("canvas");
sourceCanvas.width = sourceCanvas.height = 512;
const ctx = sourceCanvas.getContext("2d");
for (let y = 0; y < 512; y += 32) {
for (let x = 0; x < 512; x += 32) {
ctx.fillStyle = ((x + y) / 32) % 2 === 0 ? "#a8d5d5" : "#527c96";
ctx.fillRect(x, y, 32, 32);
}
}
const tex = gl.createTexture();
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, tex);
gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA,
gl.RGBA, gl.UNSIGNED_BYTE, sourceCanvas);
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.uniform1i(gl.getUniformLocation(program, "uTexture"), 0);
gl.uniform2f(gl.getUniformLocation(program, "uCenter"), 0.5, 0.5);
const timeLocation = gl.getUniformLocation(program, "uTime");
gl.viewport(0, 0, canvas.width, canvas.height);
console.log("WebGL2 ready");
function draw(milliseconds) {
gl.uniform1f(timeLocation, milliseconds * 0.001);
gl.drawArrays(gl.TRIANGLES, 0, 3);
requestAnimationFrame(draw);
}
requestAnimationFrame(draw);
</script>
</html>预期输出(浏览器开发者工具控制台):
WebGL2 ready预期页面效果:出现蓝灰与青绿色的棋盘,中心附近的方格边缘呈环形弯曲,弯曲区域随时间向外传播并逐渐变弱。整张棋盘不会平移,外缘基本保持原样。
验证参数与处理异常
- 把片元着色器中的
0.02改成0.0,刷新后应恢复笔直棋盘;这是验证扭曲确实来自 UV 偏移的最直接方法。 - 把相位中的
5.0改成0.0,刷新后波纹应固定不动;改成10.0则传播速度翻倍。 - 把
60.0改成100.0,相邻环纹间距变小;把衰减系数4.0改成8.0,可见扭曲更集中于中心。
如果出现黑屏,先检查控制台的着色器编译或链接错误,尤其确认 #version 300 es 位于着色器字符串首行、片元着色器声明了 out vec4 outColor。如果纹理上下颠倒,检查上传前是否执行 gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true)。若采样越界形成重复图案,确认 sampleUv 被限制在 0~1,且两个纹理环绕方向使用 CLAMP_TO_EDGE。