Raycaster 与对象交互

把鼠标坐标转换为 NDC,使用 Raycaster 实现点击、悬浮、高亮和模型属性面板。

🎯 引言

学完这篇文章,你能判断用户点击了哪个三维对象,处理悬浮高亮和选中状态,并把命中的对象信息展示到 Vue 面板中。

🧱 从屏幕坐标到 NDC

鼠标事件给出的是页面像素坐标,而 Raycaster 需要标准化设备坐标(NDC):x、y 的范围都是 -1 到 1,原点在画布中心。

const pointer = new THREE.Vector2();

const updatePointer = (event) => {
    const rect = renderer.domElement.getBoundingClientRect();
    pointer.x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
    pointer.y = -((event.clientY - rect.top) / rect.height) * 2 + 1;
};

不能直接用 window.innerWidth 计算,因为 canvas 可能只占页面的一部分,或者在滚动容器中。

🎯 Raycaster 命中对象

setFromCamera 根据相机和 NDC 发出一条射线,intersectObjects 返回按距离排序的命中结果:

const raycaster = new THREE.Raycaster();
const selectable = [cube, sphere];

const pick = (event) => {
    updatePointer(event);
    raycaster.setFromCamera(pointer, camera);

    const hits = raycaster.intersectObjects(selectable, true);
    const selected = hits[0]?.object || null;
    if (selected) {
        console.log(selected.name, selected.userData);
    }
};

renderer.domElement.addEventListener('click', pick);

第二个参数为 true 时,会递归检查子对象,适合拾取 glTF 模型。命中的可能是模型内部的 Mesh,通常要沿 parent 向上找到带有业务 userData 的根节点。

✨ 高亮与属性面板

选中高亮时要保存原材质状态,避免多次点击后无法恢复:

let selected = null;
let oldColor = null;

const selectObject = (object) => {
    if (selected?.material?.color && oldColor) {
        selected.material.color.copy(oldColor);
    }

    selected = object;
    if (!selected?.material?.color) return;

    oldColor = selected.material.color.clone();
    selected.material.color.set(0xffaa33);
};

在 Vue 中可以把 selected.userData 复制给响应式状态,再由普通模板展示名称、类型和业务 id。Three.js 负责画布内对象,Vue 负责画布外信息面板,边界会更清晰。

下面的演示包含两个带有 name 和 userData.id 的方块。点击方块后,组件会用 Raycaster 找到实际命中的 Mesh,保存原颜色并显示对象名称和业务 id:

点击蓝色或橙色方块

悬浮交互需要在 pointermove 中重复拾取,并处理“从对象移开”的情况。为了避免频繁改变材质,可以只在命中对象发生变化时更新高亮。

🧰 拖拽对象的工具

如果需求是让用户直接移动、旋转或缩放选中的对象,可以使用附加模块 TransformControls:

import { TransformControls } from 'three/addons/controls/TransformControls.js';

const transformControls = new TransformControls(camera, renderer.domElement);
transformControls.attach(selected);
scene.add(transformControls.getHelper());

它和 OrbitControls 同时使用时,要在拖拽期间临时关闭 OrbitControls 的旋转,避免两个控制器同时响应指针事件。

Raycaster 是“从相机向场景发射检测线”,不是根据 DOM 元素查找对象。对象是否命中取决于相机、canvas 坐标、物体可见性和几何体范围。

🧾 小节总结

  • 鼠标位置要按 canvas 矩形转换成 NDC。
  • setFromCamera 建立射线,intersectObjects 返回命中对象。
  • 检查 glTF 子对象时使用递归参数 true。
  • 选中高亮要保存和恢复原材质状态。
  • Vue 适合展示选中对象的属性面板,Three.js 负责三维画布。
  • TransformControls 适合编辑对象的位置、旋转和缩放。

❓ 知识问答

Q1:为什么点击位置总是偏移?

通常是把窗口尺寸当成 canvas 尺寸,或忘记减去 canvas 的 getBoundingClientRect() 左上角位置。

Q2:为什么命中的是模型内部零件?

Raycaster 返回实际相交的 Mesh。可以沿父级查找带有 userData.modelId 的业务根节点。

Q3:为什么点击后材质颜色无法恢复?

如果没有保存原颜色,后续只能重新猜一个颜色。选中前用 color.clone() 保存,取消选中时复制回去。

🧪 小练习

创建三个带名字的几何体,实现点击后将命中对象的 name 和 userData.id 输出到控制台,并让上一次选中的对象恢复原色。

// 请在这里编写代码

🎉 你已经能让用户真正“点到”三维对象了。下一篇处理渲染器配置、响应式尺寸和性能边界。