Web 图形与 3D / 系统课时

通过 UV 偏移制作波纹扭曲

通过 UV 偏移制作波纹扭曲

本课用一张程序生成的棋盘纹理制作向外扩散的水波扭曲。你将从当前片元到波源的距离计算周期性偏移,再用偏移后的 UV 采样原纹理,得到持续运动、中心逐渐衰减的波纹,并学会验证边界与参数是否正确。

学习目标

  • 分清片元原始 UV 与纹理实际采样 UV,理解径向波纹为何只扭曲图像。
  • 使用正弦相位、径向方向和指数衰减控制波纹密度、速度与强度。
  • 运行一个无需外部图片的 WebGL2 示例,并检查纹理方向与采样边界。

用径向距离改变采样位置

普通纹理采样直接取 texture(uTexture, vUv);波纹扭曲则先计算新坐标 p',再读取 texture(uTexture, p')。被移动的是取色位置,画布上的片元和三角形并没有移动。

设当前 UV 为 p、波源中心为 c、半径为 r,一个带衰减的向外传播波纹可写成:

p′=p+p−cmax⁡(r,10−4) 0.02sin⁡(60r−5t)e−4r,r=∥p−c∥p'=p+\frac{p-c}{\max(r,10^{-4})}\,0.02\sin(60r-5t)e^{-4r},\quad r=\lVert p-c\rVert

这里 t 是运行秒数。方向向量由 p-c 归一化得到;波源处用 max(r, 0.0001) 避免除以零。60r-5t 的相位随时间变化,使同一波峰沿半径增大的方向移动。

参数 本例取值 改动后的效果
最大偏移幅度 0.02 UV 越大,格线弯曲越明显
径向频率 60.0 越大,相邻波纹越密
时间角速度 5.0 越大,波纹向外移动越快
衰减系数 4.0 越大,影响范围越靠近中心

原始 UV 与径向波纹偏移后采样位置的对应关系

运行完整的 WebGL2 页面

新建 ripple.html,粘贴下面的完整代码并用支持 WebGL2 的现代浏览器打开。程序用离屏 Canvas 绘制 512×512 棋盘并上传为纹理,不依赖外部图片、服务器或第三方库;显示画布也设为正方形,避免把圆形波纹压成椭圆。

html
<!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>

预期输出(浏览器开发者工具控制台):

text
WebGL2 ready

预期页面效果:出现蓝灰与青绿色的棋盘,中心附近的方格边缘呈环形弯曲,弯曲区域随时间向外传播并逐渐变弱。整张棋盘不会平移,外缘基本保持原样。

验证参数与处理异常

  1. 把片元着色器中的 0.02 改成 0.0,刷新后应恢复笔直棋盘;这是验证扭曲确实来自 UV 偏移的最直接方法。
  2. 把相位中的 5.0 改成 0.0,刷新后波纹应固定不动;改成 10.0 则传播速度翻倍。
  3. 把 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。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过 UV 偏移制作波纹扭曲

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

登录哪都通