故障排查

本节涵盖使用网格样条工具时常见的问题及解决方法。

地形贴合问题

网格未贴合地形

问题：对象漂浮在地面上方或下方。

原因：垂直偏移设置不当或未启用“贴合地形”功能。

解决方法：

• 检查垂直偏移是否设为零
• 确保已启用“贴合地形”按钮
• 如果问题仍然存在，可能是网格包围盒与实际网格内容不匹配
• 在 Blender 中检查网格是否存在几何问题

组件间距问题

对象过于接近或过远

问题：网格沿样条线分布不均匀。

原因：间距设置错误或网格尺寸与内容不符。

解决方法：

• 在工具窗口调整间距滑块
• 检查网格包围盒是否与实际网格内容匹配
• 工具会采用网格最大边长来计算间距
• 如果网格长度远大于宽度，横向摆放时可能会出现间隙
• 在组件列表中重新排序网格（将其他网格设为主组件）

最后一个网格超出末节点

问题：样条线上的最后一个网格超过了最后一个节点。

原因：固定尺寸的网格（TSStatics）无法完全整除样条线长度，会有剩余部分。

解决方法：

• 固定尺寸网格出现此问题属正常现象
• 工具根据间距摆放网格，而非精确匹配样条线长度
• 通过移动最后一个节点调整样条线长度，使其更适合网格大小
• 使用起始/结束端盖完善样条线两端
• 可通过调整间距最小化剩余部分

朝向问题

网格方向错误

问题：对象沿样条线方向摆放不正确。

原因：网格旋转设置未正确配置。

解决方法：

• 使用直线预旋转控制（绕Z轴分别为0°、90°、180°、270°）
• 这些控制项在 Mesh Spline 和 Assembly Spline 工具中都可用
• 检查网格在源文件中的朝向是否正确
• 在工具窗口调整方向设置

端盖问题

起始和结束端盖缺失

问题：样条线的起点和终点未正确加盖。

原因：未勾选端盖复选框或选择了不合适的网格。

解决方法：

• 确保已启用起始/结束端盖复选框
• 从组件列表中选择合适的端盖网格
• 检查端盖网格尺寸是否适配样条线
• 确认端盖网格没有几何问题

网格质量问题

网格导入或显示异常

问题：网格未能正确加载或出现视觉瑕疵。

原因：网格文件损坏或包含不受支持的特性。

解决方法：

• 检查网格文件是否损坏
• 确认网格格式是否受支持
• 在 Blender 或其他三维软件中排查几何体异常
• 检查控制台导入警告或错误信息
• 确认网格包围盒与实际几何体匹配

性能问题

大量网格时工具变慢

问题：处理复杂样条线时工具响应变慢甚至卡死。

原因：样条线实例数过多或单条样条线过长。

解决方法：

• 减少沿样条线的网格数量
• 将过长的样条线拆分为更短的段落
• 尽量简化复杂的网格模型
• 减少网格种类的数量

样条线可见性问题

网格样条线消失

问题：样条线变得不可见或难以找到。

原因：可能被放置在地下、画面外或存在颜色/光照冲突。

解决方法：

• 使用“跳转到样条”按钮定位并聚焦到目标样条线
• 检查样条线是否位于地下或画面外
• 调整光照或色彩设置，避免可见性冲突

会话管理

网格样条线在会话间消失

问题：重启工具时已有工作内容丢失。

原因：默认情况下，样条线不会在会话之间自动保存。

解决方法：

• 使用往返恢复系统导入已有样条线
• 在场景树中选择网格对象以推测样条线参数
• 工具可自动从场景网格中恢复样条线

何时反馈 Bug

如果你遇到以下问题，可能是Bug导致：

• 工具窗口无故冻结
• 网格导入完全失败
• 撤销/重做历史不起作用
• 文件损坏或数据无法读取

建议：请重载工具后再次尝试。如果问题依旧，请检查控制台错误信息，并附上详细复现步骤反馈问题。