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 的旋转,避免两个控制器同时响应指针事件。
🧾 小节总结
- 鼠标位置要按 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 输出到控制台,并让上一次选中的对象恢复原色。
// 请在这里编写代码
🎉 你已经能让用户真正“点到”三维对象了。下一篇处理渲染器配置、响应式尺寸和性能边界。
