UD5工具箱
常见问题
如何添加3D模型到场景中？
在编辑器界面的工具栏或侧边栏中找到几何体选择区域，其中列出了所有可用的3D几何体类型。点击你需要的几何体按钮（如立方体、球体等），对应的3D模型会自动创建并放置在场景中央位置。你也可以通过拖拽方式将模型从工具栏拖入场景预览区域。添加后的模型会出现在左侧的场景对象列表中，你可以继续对其属性进行编辑和调整。
如何调整3D对象的位置和旋转？
首先在左侧场景对象列表中点击选中你要调整的对象，或者直接在3D预览区域中点击选择。选中后，右侧属性面板会显示该对象的全部属性。在"变换"（Transform）区域中，你可以修改位置（Position）的X、Y、Z坐标值来移动对象，修改旋转（Rotation）的角度值来调整对象朝向，修改缩放（Scale）值来调整对象大小。所有修改都会实时反映在预览画面中。
不同类型的灯光有什么区别？各适合什么场景？
环境光（AmbientLight）提供均匀的全局照明，不产生阴影，适合作为基础照明层确保场景不会太暗；点光源（PointLight）从一个点向四周发散，亮度随距离衰减，适合模拟灯泡、蜡烛等点状光源；方向光（DirectionLight）沿固定方向发射平行光线，不衰减，适合模拟太阳光等远距离光源；聚光灯（SpotLight）产生锥形光束，有明确的方向和照射范围，适合手电筒、舞台灯等效果；半球光（HemisphereLight）分别控制天空色和地面色，模拟自然环境的漫反射光照。通常建议组合使用多种灯光来达到最佳效果。
编辑器支持哪些几何体类型？
编辑器内置支持8种常用3D几何体：立方体（Box）是最基础的六面体，适合建筑、箱子等；球体（Sphere）用于创建圆球形物体；圆柱体（Cylinder）用于创建柱状物体，支持分别设置上下底面半径；圆锥体（Cone）用于创建锥形物体；平面（Plane）是一个二维矩形面，适合地面、墙壁等；圆环（Torus）是甜甜圈形状的环面体；环形结（TorusKnot）是缠绕成结的复杂环面；十二面体（Dodecahedron）是由12个五边形面组成的正多面体。每种几何体都支持自定义参数调整。
如何导出或保存我的场景？
编辑器提供了截图导出功能，你可以点击工具栏中的截图按钮，将当前场景的渲染画面保存为PNG格式的图片文件。如果需要导出场景的Three.js数据（如JSON格式的场景描述），可以查看编辑器是否提供数据导出功能，将场景中所有对象的类型、位置、旋转、缩放、材质等参数导出为结构化数据，方便在自己的Three.js项目中加载和复现场景。目前编辑器主要面向场景预览和调试用途，完整项目中的场景构建建议参考Three.js官方文档编写代码。
在移动端设备上能正常使用吗？
可以的。编辑器全面支持触屏设备操作，包括iPad、Android平板和智能手机。在触屏设备上，你可以使用单指拖拽来旋转视角，双指捏合来缩放场景，点击对象进行选择，长按进行右键等效操作。属性面板也针对触屏进行了优化，输入框和滑块都支持触摸操作。建议在屏幕较大的平板设备上使用以获得最佳编辑体验，手机屏幕由于尺寸限制可能会影响操作精度。
场景对象列表有什么作用？
场景对象列表是编辑器左侧的管理面板，以列表形式展示当前场景中的所有对象。它的主要作用包括：一、快速定位和选择场景中的对象，特别是在场景复杂、对象重叠时比直接在预览区点击更方便；二、查看场景的整体结构和对象数量；三、对对象进行删除操作，清理不需要的元素；四、了解每个对象的类型和名称，便于管理。选中列表中的对象后，右侧属性面板会同步显示该对象的详细属性。
编辑器的性能如何？能处理复杂场景吗？
编辑器基于 Three.js 构建，继承了 Three.js 优秀的渲染性能。对于包含数十个几何体和灯光的中等复杂度场景，现代浏览器都能流畅运行。但需要注意，场景复杂度（几何体面数、灯光数量、阴影计算等）会直接影响渲染性能。如果场景过于复杂导致卡顿，建议适当降低几何体的分段数、减少灯光数量或关闭阴影效果。编辑器主要面向场景原型设计和功能验证，超大规模的生产级场景建议使用专业的3D建模软件和本地开发环境。