用途:面向 Three.js 场景的交互与用户输入处理,包括点击检测、对象选择、悬停反馈、拖拽与相机控制。
主要能力:
- 射线检测(Raycaster):通过 raycaster.setFromCamera(mouse, camera) 或 raycaster.set(origin, direction) 生成射线,用 intersectObjects(objects, recursive) 获取交点,返回 distance、point、face、object、uv、normal、instanceId 等信息。可设置 near/far、params.Line.threshold、params.Points.threshold 与 layers 过滤。
- 鼠标与触摸输入:将 clientX/clientY 归一化为 -1 到 1 的向量;针对画布可用 getBoundingClientRect 换算;通过 touchstart 与 event.touches[0] 支持单指触控。
- 相机控制器:OrbitControls(阻尼、角度与缩放限制、自动旋转、target、需在动画循环调用 update)、FlyControls、FirstPersonControls、PointerLockControls(lock/unlock 事件与键盘移动)、TrackballControls、MapControls、TransformControls(translate/rotate/scale 模式、local/world 空间、dragging-changed 事件)、DragControls(dragstart/drag/dragend)。
- 选择与悬停:点击选中并高亮、SelectionBox 与 SelectionHelper 框选、mousemove 悬停改变颜色与光标。
- 坐标换算与射线求交:worldToScreen、screenToWorld、raycaster.ray.intersectPlane 获取地面交点。
使用方式:从 three 导入 THREE,从 three/addons/controls/... 导入所需控制器;创建 Raycaster 与 Vector2,在事件回调中更新鼠标坐标并调用 setFromCamera;在渲染循环中调用 controls.update()(阻尼、自动旋转、Fly、第一人称等需要)。
适用场景:三维场景中的模型点选、悬停提示、拖拽摆放、编辑器式变换操作、第一人称漫游与地图式浏览。
限制与性能建议:建议节流 mousemove、用 layers 过滤、使用不可见的简化碰撞网格、不需要时设置 controls.enabled = false。资料未提供额外依赖、安装命令或收费信息。