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 接收并生成像素颜色。

ShaderMaterial 驱动网格的数据流

Three.js 的 ShaderMaterial 会自动提供 position、uv、modelViewMatrix、projectionMatrix 等内建声明;不要在自己的代码里重复声明它们。此处使用的 uTime 是自定义变量,必须同时出现在材质的 uniforms 和用到它的 GLSL 阶段。

写一个能看到变化的 ShaderMaterial

以下示例适用于支持 WebGL2 的现代浏览器,Three.js 固定使用 0.180.0。将完整内容保存为 index.html。平面细分为 40×40 个网格单元,使顶点形变不只发生在四个角上。

html
<!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 的静态文件服务器:

bash
python3 -m http.server 8000 --bind 127.0.0.1

预期输出(省略访问日志):

text
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 更新链路,之后可将同一材质换绑到其他具有相应顶点属性的几何体上。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 ShaderMaterial 驱动网格

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

登录哪都通