Web 图形与 3D / 系统课时
ShaderMaterial 动态渐变
ShaderMaterial 动态渐变
将展厅里的纯色背景板改成缓慢流动的青蓝渐变,不用序列帧或纹理。本课用 ShaderMaterial 自定义顶点与片元着色器,让每个像素依据 UV 坐标混色,并从 JavaScript 每帧传入时间,完成可调速度和波幅的动态效果。
学习目标
- 区分顶点着色器传递坐标与片元着色器计算颜色的职责。
- 用
uTimeUniform 驱动sin波形和mix渐变。 - 独立运行示例,并定位画面静止、全黑或颜色偏差的问题。
渐变数据怎样到达像素
ShaderMaterial 接收 vertexShader、fragmentShader 和 uniforms。平面网格的 uv 通常覆盖 0~1:左下角接近 (0, 0),右上角接近 (1, 1)。顶点着色器将 uv 赋给 varying vec2 vUv;GPU 在三角形内部插值后,每个片元取得自己的 vUv,因此不用给每个像素单独上传坐标。
时间走另一条路径:JavaScript 动画循环更新 material.uniforms.uTime.value,片元着色器读取这一全局一致的秒数。sin(vUv.x * 6.2831853 + uTime * 1.2) 制造横向波动,smoothstep 生成平滑混色比例,mix 在深蓝与青绿之间插值。渲染一帧后重新传入时间,渐变边界就会移动。

创建可运行的渐变背景板
把下面代码保存为 index.html。示例固定使用 Three.js 0.180.0,通过 CDN 加载,无须打包。浏览器需联网并支持 WebGL;材质贴在 PlaneGeometry(4, 2.4) 上,摄像机位于 Z=5,避免加入灯光影响判断。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>动态渐变</title>
<style>
body { margin: 0; overflow: hidden; }
canvas { display: block; }
</style>
</head>
<body>
<script type="module">
import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xeff4f7);
const camera = new THREE.PerspectiveCamera(
45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.z = 5;
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.outputColorSpace = THREE.SRGBColorSpace;
document.body.appendChild(renderer.domElement);
const material = new THREE.ShaderMaterial({
uniforms: { uTime: { value: 0 } },
vertexShader: `
varying vec2 vUv;
void main() {
vUv = uv;
gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
}
`,
fragmentShader: `
uniform float uTime;
varying vec2 vUv;
void main() {
// 时间控制相位;UV 决定当前位置的渐变因子
float wave = 0.15 * sin(vUv.x * 6.2831853 + uTime * 1.2);
float t = smoothstep(0.0, 1.0, vUv.y + wave);
vec3 low = vec3(0.01, 0.12, 0.25);
vec3 high = vec3(0.04, 0.70, 0.56);
gl_FragColor = vec4(mix(low, high, t), 1.0);
#include <colorspace_fragment>
}
`
});
const panel = new THREE.Mesh(new THREE.PlaneGeometry(4, 2.4), material);
scene.add(panel);
const start = performance.now();
renderer.setAnimationLoop(() => {
// 只更新 Uniform,不逐帧重新创建 ShaderMaterial
material.uniforms.uTime.value = (performance.now() - start) / 1000;
renderer.render(scene, camera);
});
window.addEventListener('resize', () => {
// 窗口变化时同步投影宽高比和画布尺寸
camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(window.innerWidth, window.innerHeight);
});
</script>
</body>
</html>预期结果:页面显示浅灰背景和居中的长方形渐变板。渐变从下方深蓝过渡到上方青绿,颜色交界呈缓慢水平起伏;画面持续变化,但矩形本身不移动。浏览器控制台不应有着色器编译错误。
在 index.html 所在目录启动静态服务(需要 Python 3):
python -m http.server 8000预期输出(监听地址因系统而异):
Serving HTTP on <HOST> port 8000 ...用浏览器访问 http://localhost:8000/ 查看。若 python 不指向 Python 3,可使用 python3 -m http.server 8000;若端口被占用,换一个未占用端口并相应修改访问地址。
调整渐变形状和速度
本例的 vUv.y 决定渐变从下到上的基础方向,vUv.x 决定波浪在水平方向的相位。片元着色器中 smoothstep(0.0, 1.0, vUv.y + wave) 会把输入平滑限制到 0~1;这个值越接近 1,青绿色占比越高。观察效果时每次只改一个参数:
| 修改位置 | 当前值 | 改为 | 可以观察到 |
|---|---|---|---|
sin 前的波幅系数 |
0.15 |
0.05 |
波浪起伏明显减弱 |
uTime 的速度系数 |
1.2 |
2.4 |
完整波动周期由约 5.24 秒缩短至约 2.62 秒 |
vUv.x 的频率系数 |
6.2831853 |
12.5663706 |
板面横向由约 1 个波峰周期变为 2 个 |
smoothstep 的两个阈值 |
0.0, 1.0 |
0.25, 0.75 |
两色之间的过渡带变窄 |
Uniform 名称必须在 JavaScript 的 uniforms 与 GLSL 的 uniform float uTime 中一致。修改 .value 即可把新数值用于后续渲染;不要在动画循环内反复 new THREE.ShaderMaterial(),也不用为了修改普通 Uniform 每帧设置 material.needsUpdate = true。
验证与常见故障
先把 uTime 的更新值临时改为常量 0:预期渐变静止;恢复秒数后重新运动。再将 wave 的系数改为 0.0:预期得到纯粹的竖直渐变。这样可以分别判断时间更新和坐标混色是否正确。检查完把两个改动复原。
- 画面全黑或没有矩形:打开浏览器开发者工具的 Console,检查 GLSL 编译错误和 CDN 请求失败。确认顶点、片元着色器都声明同名
varying vec2 vUv,网格具有uv属性。 - 渐变存在但不动:确认
renderer.setAnimationLoop持续执行,且更新的是material.uniforms.uTime.value,不是另建了一个同名变量。 - 颜色明显偏暗或偏亮:示例按线性颜色计算并通过
#include <colorspace_fragment>转换到输出色彩空间;不要重复做 sRGB 转换。此材质不会自动拥有标准 PBR 光照反射,适合自发光风格的展厅装饰面,而不是直接替换所有产品表面材质。
用于数字展厅时,可以把同一材质贴到背景墙或信息底板,并将时间速度降到 0.4~0.8,让动画不会抢走产品主体的注意力。