Web 图形与 3D / 系统课时

悬停高亮如何保留原始材质

悬停高亮如何保留原始材质

产品展示中,多个零件常复用同一个材质。直接修改射线命中网格的颜色,可能让其他零件一起变色。本篇用 Raycaster 找到悬停对象,在目标切换时克隆材质,并在移出时恢复原始引用、释放临时副本。

学习目标

  • 识别共享材质引用导致的联动高亮。
  • 实现命中切换时的材质保存、克隆与恢复。
  • 验证从 A 切到 B、移到空白处和离开画布时的行为。

为什么直接改材质会串色

Mesh.material 保存的是材质对象的引用。假设零件 A 和 B 都使用同一个 MeshStandardMaterial,执行 A.material.emissive.setHex(0x00ffcc) 会同时改变 B 的外观,因为两者访问的是同一实例。离开时再写死为黑色也不安全:原材质可能本来就有自发光颜色。

推荐保留原始材质对象,不修改它;只把被悬停网格的 material 临时指向克隆副本。这样其他共享原材质的网格不会受影响,退出时也无须猜测原来的颜色、贴图或粗糙度。

悬停目标变化时如何恢复

单指针、同一时刻只高亮一个网格时,用 hovered、original 和 temporary 三个变量保存状态。按以下顺序切换:

  1. 新命中对象与 hovered 相同:不做任何材质操作。
  2. 如果原来有悬停对象:先将其 material 恢复为 original,再对旧的 temporary 调用 dispose()。
  3. 如果新命中对象存在:保存其当前材质为 original,调用 clone(),只调整副本的 emissive,最后把副本赋给新对象。
  4. 新对象为 null 时保持无悬停状态;鼠标移出画布也执行这一步。

共享原材质与悬停副本的引用关系及恢复顺序

在浏览器中运行完整示例

准备已安装 Node.js 的环境,使用 Vite 创建原生 JavaScript 项目,并安装 Three.js:

bash
npm create vite@latest hover-demo -- --template vanilla
cd hover-demo
npm install
npm install three
npm run dev

预期输出(实际端口可能不同):

text
Local: http://localhost:<PORT>/

将 src/main.js 全部替换为以下代码。示例放置两个共享同一材质的立方体,射线只检测这两个可交互对象;坐标使用画布的实际边界换算,避免页面布局变化造成命中偏移。

js
import * as THREE from 'three';

document.body.style.margin = '0';

const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf3f7fa);

const camera = new THREE.PerspectiveCamera(
  50, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(0, 1, 7);
camera.lookAt(0, 0, 0);

const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
renderer.domElement.style.display = 'block';
document.body.appendChild(renderer.domElement);

scene.add(new THREE.AmbientLight(0xffffff, 0.8));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(3, 5, 5);
scene.add(light);

// 两个网格共用同一个材质实例,用来检验是否发生串色。
const shared = new THREE.MeshStandardMaterial({
  color: 0x315c74, roughness: 0.55, metalness: 0.15
});
const geometry = new THREE.BoxGeometry(1.4, 1.4, 1.4);
const meshes = [-1.35, 1.35].map((x) => {
  const mesh = new THREE.Mesh(geometry, shared);
  mesh.position.x = x;
  scene.add(mesh);
  return mesh;
});

const raycaster = new THREE.Raycaster();
const pointer = new THREE.Vector2();
let hovered = null;
let original = null;
let temporary = null;

function switchHover(next) {
  if (next === hovered) return; // 同一目标不重复克隆
  if (hovered) {
    hovered.material = original;
    temporary.dispose(); // 仅释放自行创建的副本
  }
  hovered = next;
  original = null;
  temporary = null;
  if (hovered) {
    original = hovered.material;
    temporary = original.clone();
    temporary.emissive.setHex(0x00a896);
    temporary.emissiveIntensity = 0.9;
    hovered.material = temporary;
  }
  renderer.domElement.style.cursor = hovered ? 'pointer' : 'default';
}

renderer.domElement.addEventListener('pointermove', (event) => {
  const rect = renderer.domElement.getBoundingClientRect();
  pointer.set(
    ((event.clientX - rect.left) / rect.width) * 2 - 1,
    -((event.clientY - rect.top) / rect.height) * 2 + 1
  );
  raycaster.setFromCamera(pointer, camera);
  const hit = raycaster.intersectObjects(meshes, false)[0];
  switchHover(hit ? hit.object : null);
});
renderer.domElement.addEventListener('pointerleave', () => switchHover(null));

window.addEventListener('resize', () => {
  camera.aspect = window.innerWidth / window.innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(window.innerWidth, window.innerHeight);
});
renderer.setAnimationLoop(() => renderer.render(scene, camera));

预期结果:浏览器里出现两个深蓝色立方体。鼠标停在左侧时仅左侧泛青绿色高光,移到右侧时左侧恢复原色、右侧高亮;移至空白处时两者都恢复。终端中的 <PORT> 只是动态端口占位符。

如何验收与避免泄漏

依次测试 A → B → 空白区域 → A → 画布外:始终只能有一个立方体高亮;退出后两者的 material 引用应重新等于 shared。在同一立方体内部反复移动指针不应创建新材质,因为 next === hovered 会提前返回。

dispose() 只用于高亮副本,不要对仍被其他网格使用的 shared 调用它。材质克隆通常仍引用原贴图,释放临时材质也不会自动释放这些共享贴图。示例适用于每个网格只有一个 MeshStandardMaterial 的场景;多材质数组、ShaderMaterial 或 InstancedMesh 需要分别处理材质类型与实例级状态。如果相机或零件会在鼠标静止时移动,还应在变化后重新执行射线检测,避免高亮停留在旧目标。

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

目录与阅读设置

阅读设置

17

记录一个想法

悬停高亮如何保留原始材质

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

登录哪都通