Web 图形与 3D / 系统课时

ShaderMaterial 动态渐变

ShaderMaterial 动态渐变

将展厅里的纯色背景板改成缓慢流动的青蓝渐变,不用序列帧或纹理。本课用 ShaderMaterial 自定义顶点与片元着色器,让每个像素依据 UV 坐标混色,并从 JavaScript 每帧传入时间,完成可调速度和波幅的动态效果。

学习目标

  • 区分顶点着色器传递坐标与片元着色器计算颜色的职责。
  • 用 uTime Uniform 驱动 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 在深蓝与青绿之间插值。渲染一帧后重新传入时间,渐变边界就会移动。

ShaderMaterial 的 UV 坐标、时间 Uniform 与片元颜色计算关系

创建可运行的渐变背景板

把下面代码保存为 index.html。示例固定使用 Three.js 0.180.0,通过 CDN 加载,无须打包。浏览器需联网并支持 WebGL;材质贴在 PlaneGeometry(4, 2.4) 上,摄像机位于 Z=5,避免加入灯光影响判断。

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

bash
python -m http.server 8000

预期输出(监听地址因系统而异):

text
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,让动画不会抢走产品主体的注意力。

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

目录与阅读设置

阅读设置

17

记录一个想法

ShaderMaterial 动态渐变

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

登录哪都通