Web 图形与 3D / 系统课时
让 ShaderMaterial 驱动网格
让 ShaderMaterial 驱动网格
把普通平面换成自定义着色器材质,让顶点随时间轻微起伏、像素颜色沿 UV 坐标渐变。完成后你会得到一个可直接运行的 WebGL2 页面,并能确认 GLSL3、网格绑定和时间 uniform 都已生效。
学习目标
- 使用
THREE.ShaderMaterial创建 GLSL3 材质并绑定网格。 - 区分顶点阶段的坐标变换与片元阶段的颜色输出。
- 更新
uTime实现动画,并利用浏览器控制台排查错误。
网格、材质与渲染器如何配合
PlaneGeometry 提供每个顶点的 position 和 uv;ShaderMaterial 保存顶点、片元程序和 uniforms;new THREE.Mesh(geometry, material) 将两者绑定,最终由 WebGLRenderer 绘制。顶点着色器写入 gl_Position,同时用 out vec2 vUv 传递纹理坐标;光栅化时插值后,片元着色器以 in vec2 vUv 接收并生成像素颜色。

Three.js 的 ShaderMaterial 会自动提供 position、uv、modelViewMatrix、projectionMatrix 等内建声明;不要在自己的代码里重复声明它们。此处使用的 uTime 是自定义变量,必须同时出现在材质的 uniforms 和用到它的 GLSL 阶段。
写一个能看到变化的 ShaderMaterial
以下示例适用于支持 WebGL2 的现代浏览器,Three.js 固定使用 0.180.0。将完整内容保存为 index.html。平面细分为 40×40 个网格单元,使顶点形变不只发生在四个角上。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>GLSL3 ShaderMaterial</title>
<style>
html, body { margin: 0; width: 100%; height: 100%; overflow: hidden; }
canvas { display: block; }
</style>
<script type="importmap">
{"imports":{"three":"https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js"}}
</script>
</head>
<body>
<script type="module">
import * as THREE from 'three';
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x101828);
const camera = new THREE.PerspectiveCamera(
45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.z = 3.4;
const geometry = new THREE.PlaneGeometry(2, 2, 40, 40);
const material = new THREE.ShaderMaterial({
glslVersion: THREE.GLSL3,
uniforms: { uTime: { value: 0 } },
vertexShader: `
out vec2 vUv;
uniform float uTime;
void main() {
vUv = uv;
vec3 p = position;
// 只改变顶点的 z 坐标,保留相机投影
p.z += 0.16 * sin(p.x * 7.0 + uTime) * sin(p.y * 7.0 + uTime);
gl_Position = projectionMatrix * modelViewMatrix * vec4(p, 1.0);
}
`,
fragmentShader: `
in vec2 vUv;
uniform float uTime;
out vec4 fragColor;
void main() {
// UV 决定红绿分量,时间决定蓝色分量
vec3 rgb = vec3(vUv.x, vUv.y, 0.5 + 0.5 * sin(uTime));
fragColor = vec4(rgb, 1.0);
}
`
});
scene.add(new THREE.Mesh(geometry, material));
const clock = new THREE.Clock();
renderer.setAnimationLoop(() => {
// 逐帧更新 uniform 的值,不必重新创建材质
material.uniforms.uTime.value = clock.getElapsedTime();
renderer.render(scene, camera);
});
window.addEventListener('resize', () => {
camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(window.innerWidth, window.innerHeight);
});
</script>
</body>
</html>预期结果:在深蓝背景中央看到一张连续起伏的渐变平面,横向和纵向的颜色随 UV 改变,蓝色分量持续变亮、变暗。它不需要场景灯光,因为片元着色器直接写出颜色。
启动页面并验证效果
在 index.html 所在目录运行 Python 3 的静态文件服务器:
python3 -m http.server 8000 --bind 127.0.0.1预期输出(省略访问日志):
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...访问 http://127.0.0.1:8000/index.html。若使用 Windows 且 python3 不可用,可将上述命令的 python3 改为 py;应先确认已安装 Python 3。按 F12 打开开发者工具的 Console,检查是否存在 GLSL 编译或模块加载错误。修改 p.z += ... 前面的系数 0.16 为 0.0 并刷新,平面应恢复平整;还原后起伏再次出现,这可单独证明顶点着色器已执行。
GLSL3 规则与常见黑屏
glslVersion: THREE.GLSL3 让 Three.js 为着色器添加 GLSL ES 3.00 版本指令,不要在 vertexShader 或 fragmentShader 字符串里再手写 #version 300 es。GLSL3 使用顶点阶段的 out 与片元阶段的 in 传递 vUv;片元结果写入自定义的 out vec4 fragColor,不能再用旧式 gl_FragColor。
- 画面空白且 Console 报着色器编译失败:先检查
in、out类型是否匹配,是否重复声明position,以及是否混用了varying或gl_FragColor。 - 控制台提示模块无法加载:确认本地服务器已启动、浏览器能访问 CDN,不要用
file://方式作为排错基准。 - 渐变正常但平面没有起伏:核对几何体是否有足够细分,以及
uTime.value是否在动画循环中递增。只修改 uniform 值不需要material.needsUpdate;改动着色器源码后才需要重新编译。
这张平面同时验证了网格位置、UV 插值、GLSL3 输出变量及 JavaScript 到 GPU 的 uniform 更新链路,之后可将同一材质换绑到其他具有相应顶点属性的几何体上。