Web 图形与 3D / 系统课时
组合动态材质完成交互特效页面
组合动态材质完成交互特效页面
把顶点波浪、程序化柔边遮罩和 Bloom 辉光拼成一张可交互的 WebGL2 页面。完成后,用户可以实时调整波高、速度、遮罩范围与辉光强度,并在桌面与手机宽度下检查画面和性能。
学习目标
- 用一个
ShaderMaterial联动顶点位移、片元遮罩和高亮边缘。 - 将场景绘制、辉光提取和输出变换连接成后处理链。
- 接入滑块、指针与尺寸变化事件,按可观察的标准验收。
确定页面结构与参数
使用支持 WebGL2 的现代浏览器、Python 3 和联网环境。本例固定使用 three.js 0.186.1,通过 CDN import map 加载核心库与后处理 Addons,不需要打包工具。建立一个文件 index.html,把下面代码完整保存进去。
页面只绘制一块 4.8 × 3.2 的平面,细分为 128 × 96 个网格单元。顶点着色器按时间改变深度,片元着色器计算圆形遮罩与暖色亮环;RenderPass、UnrealBloomPass、OutputPass 依次处理画面。四个滑块分别改动材质 uniform、时间推进速度或 Bloom 强度,复选框可跳过高成本辉光阶段。

实现可运行的交互页面
以下代码是完整示例,不依赖外部贴图。ShaderMaterial 自动提供 position、uv、projectionMatrix 和 modelViewMatrix,因此不重复声明这些内置变量;自定义的 uTime 等 uniform 才需要在 GLSL 中声明。启用 THREE.GLSL3 后,顶点与片元之间使用 out 和 in 传值,片元使用自定义输出变量。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>交互式 Shader 页面</title>
<style>
html,body { margin:0; width:100%; height:100%; overflow:hidden; background:#050b14; color:#e5f7fb; font:14px system-ui; }
#stage { display:block; width:100%; height:100%; }
#panel { position:fixed; top:16px; left:16px; box-sizing:border-box; width:224px; max-height:calc(100vh - 32px); overflow:auto; padding:16px; border-radius:12px; background:#0b2030e6; }
.control { display:block; margin-top:12px; }
input[type="range"] { display:block; width:100%; }
@media(max-width:600px) { #panel { top:8px; left:8px; width:190px; max-height:calc(100vh - 16px); padding:12px; } }
</style>
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.186.1/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.186.1/examples/jsm/"
}
}
</script>
</head>
<body>
<canvas id="stage" aria-label="动态波浪材质"></canvas>
<aside id="panel">
<strong>波浪 · 遮罩 · Bloom</strong>
<label class="control">波高 <output id="amplitudeValue"></output>
<input id="amplitude" type="range" min="0" max="0.5" step="0.01" value="0.18">
</label>
<label class="control">速度 <output id="speedValue"></output>
<input id="speed" type="range" min="0" max="3" step="0.1" value="1">
</label>
<label class="control">遮罩半径 <output id="radiusValue"></output>
<input id="radius" type="range" min="0.2" max="0.45" step="0.01" value="0.37">
</label>
<label class="control">辉光强度 <output id="bloomValue"></output>
<input id="bloom" type="range" min="0" max="2" step="0.1" value="0.9">
</label>
<label class="control"><input id="lowQuality" type="checkbox"> 低功耗模式(关闭 Bloom)</label>
</aside>
<script type="module">
import * as THREE from 'three';
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
import { OutputPass } from 'three/addons/postprocessing/OutputPass.js';
const canvas = document.getElementById('stage');
const renderer = new THREE.WebGLRenderer({ canvas, antialias:true });
renderer.setClearColor(0x050b14);
renderer.toneMapping = THREE.ACESFilmicToneMapping;
renderer.toneMappingExposure = 1.1;
renderer.outputColorSpace = THREE.SRGBColorSpace;
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(45, 1, 0.1, 100);
const uniforms = {
uTime: { value:0 },
uAmplitude: { value:0.18 },
uRadius: { value:0.37 }
};
const material = new THREE.ShaderMaterial({
glslVersion:THREE.GLSL3,
transparent:true,
depthWrite:false,
uniforms,
vertexShader: `
uniform float uTime, uAmplitude;
out vec2 vUv;
out float vHeight;
void main() {
vUv = uv;
float t = uTime;
// 仅移动顶点,不在每帧重建几何体
float h = sin(position.x * 3.2 + t)
* cos(position.y * 2.5 - t * 0.6) * uAmplitude;
vHeight = h;
gl_Position = projectionMatrix * modelViewMatrix * vec4(position.xy, h, 1.0);
}`,
fragmentShader: `
in vec2 vUv;
in float vHeight;
uniform float uTime, uRadius;
out vec4 fragColor;
void main() {
// 按平面宽高比校正,避免圆形遮罩被拉伸
float r = length((vUv - 0.5) * vec2(1.5, 1.0));
float mask = 1.0 - smoothstep(uRadius - 0.04, uRadius + 0.04, r);
float bands = 0.5 + 0.5 * sin(vUv.x * 14.0 + vUv.y * 7.0
+ vHeight * 13.0 - uTime);
vec3 base = mix(vec3(0.01, 0.07, 0.13), vec3(0.05, 0.46, 0.54), bands);
// 大于 1 的线性高亮提供 Bloom 的亮区
float rim = exp(-abs(r - (uRadius - 0.045)) * 65.0);
fragColor = vec4(base + rim * vec3(2.5, 1.3, 0.55), mask);
}`
});
const geometry = new THREE.PlaneGeometry(4.8, 3.2, 128, 96);
const mesh = new THREE.Mesh(geometry, material);
scene.add(mesh);
// 场景先渲染为纹理,再提取辉光,最后完成色调映射
const composer = new EffectComposer(renderer);
composer.addPass(new RenderPass(scene, camera));
const bloomPass = new UnrealBloomPass(new THREE.Vector2(1, 1), 0.9, 0.35, 0.85);
composer.addPass(bloomPass);
composer.addPass(new OutputPass());
const params = { speed:1 };
const controls = {
amplitude: v => uniforms.uAmplitude.value = v,
speed: v => params.speed = v,
radius: v => uniforms.uRadius.value = v,
bloom: v => bloomPass.strength = v
};
for (const [id, setValue] of Object.entries(controls)) {
const input = document.getElementById(id);
const output = document.getElementById(id + 'Value');
const update = () => {
const value = Number(input.value);
output.value = value.toFixed(2);
setValue(value);
};
input.addEventListener('input', update);
update();
}
document.getElementById('lowQuality').addEventListener('change', e => {
bloomPass.enabled = !e.target.checked;
});
let targetX = 0, targetY = 0;
window.addEventListener('pointermove', e => {
targetX = (e.clientY / innerHeight - 0.5) * 0.3;
targetY = (e.clientX / innerWidth - 0.5) * 0.5;
});
function resize() {
const w = innerWidth, h = innerHeight;
const dpr = Math.min(devicePixelRatio || 1, 1.5);
renderer.setPixelRatio(dpr);
renderer.setSize(w, h, false);
composer.setPixelRatio(dpr);
composer.setSize(w, h);
camera.aspect = w / h;
const tanHalf = Math.tan(THREE.MathUtils.degToRad(camera.fov * 0.5));
// 让 4.8×3.2 的网格在横竖屏都完整入镜
camera.position.z = 1.2 * Math.max(3.2 / (2 * tanHalf), 4.8 / (2 * tanHalf * camera.aspect));
camera.updateProjectionMatrix();
}
window.addEventListener('resize', resize);
resize();
const clock = new THREE.Clock();
function animate() {
requestAnimationFrame(animate);
const dt = Math.min(clock.getDelta(), 0.05);
uniforms.uTime.value += dt * params.speed;
mesh.rotation.x += (targetX - mesh.rotation.x) * 0.06;
mesh.rotation.y += (targetY - mesh.rotation.y) * 0.06;
composer.render(dt);
}
animate();
</script>
</body>
</html>预期结果:通过本地服务器打开页面后,浏览器会显示青绿色动态波纹圆面、暖色发光边缘和左上角控制面板。拖动滑块时,无需刷新页面即可改变效果;移动鼠标可以使网格缓慢偏转。
代码里的 mask 作为透明度交给正常混合处理,边缘的 rim 颜色故意高于 1.0,供 Bloom 的亮度阈值 0.85 提取。renderer.toneMapping 与最后的 OutputPass 负责把高动态范围颜色转换为屏幕可显示的颜色;不要在片元 Shader 里提前把高亮钳制到 1.0。
启动页面并验证交互
在 index.html 所在目录启动本地静态服务器。这个命令以 Python 3 为例;Windows 如未提供 python3,可改用 py -3。
python3 -m http.server 8000 --bind 127.0.0.1预期控制台出现以下监听提示(不同 Python 版本的文字可能略有差异,命令会持续运行):
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...在浏览器打开 http://127.0.0.1:8000/。首次加载需访问 CDN。页面应出现深色背景上的青绿动态波纹圆面、暖色发光边缘以及左上角控制面板。依次执行下表测试,不要仅凭“页面能显示”判断项目完成。
| 操作 | 可观察的验收结果 |
|---|---|
波高 0.00 → 0.40 |
波面起伏与条纹形变明显增强;降到 0.00 后波面平整 |
速度 1.0 → 0.0 → 2.0 |
动画先冻结,再以更快速度变化 |
遮罩半径 0.20 → 0.45 |
圆形可见区域扩大,边缘始终有柔和过渡 |
辉光强度 0.0 → 1.5 |
暖色亮环周围的扩散光晕增强,遮罩轮廓仍可辨识 |
| 勾选“低功耗模式” | Bloom 被跳过,光晕消失,但波浪和遮罩继续更新 |
| 拖动指针、切换横竖屏 | 平面缓慢偏转,窗口变窄时网格完整入镜而不被拉伸 |
处理性能与交付问题
默认有效 DPR 上限为 1.5;窗口改变时,renderer 与 composer 都按 CSS 宽高重新分配绘图缓冲。用浏览器开发者工具的 Performance 面板录制约 30 秒,先在桌面测试,再用手机或设备模拟检查交互延迟;以目标设备实际帧时间作为优化依据,60 FPS 对应约 16.7 ms/帧,30 FPS 对应约 33.3 ms/帧,不能把某台机器测得的数值当成所有设备的保证。
出现黑屏时先打开 Console 检查模块加载和 Shader 编译信息。若提示模块解析失败,确认通过 http://127.0.0.1:8000/ 而不是 file:// 打开,并确认 CDN 可访问;若 GLSL 报重定义错误,检查是否重复声明了 ShaderMaterial 内置属性。波纹正常却没有辉光时,确认低功耗模式未勾选、亮环颜色未被提前截断,并核对 Pass 顺序。
若 GPU 帧时间超预算,先勾选低功耗模式验证瓶颈是否来自多级模糊;随后可将 Math.min(devicePixelRatio || 1, 1.5) 的上限改为 1.0,或把网格细分改为 80 × 60 再分别复测。单纯降低 bloomPass.strength 不会省去模糊 Pass 的计算。交付前记录目标浏览器、窗口尺寸、DPR、开关 Bloom 前后的帧时间与 Console 报错情况,留作回归基线。