故障排查
本页面列举了使用道路建造器工具时可能遇到的一些已知错误和问题。
路面未正常渲染
有时道路不会正确渲染，甚至可能在长距离内完全不显示，还可能丢失三角面片。这是一个已知的 Bug，未来会修复。目前对此问题暂无有效解决办法。
导致该问题的一个主要原因是“折叠”。如果道路曲率过大，就可能发生折叠，即道路在一侧向自身折回来。这种情况在较宽道路上更为常见，应尽量避免。折叠会导致渲染异常。
将道路的颗粒度（granularity）设置为较小值，并避免过大的曲率，可能有助于缓解该问题，但并不总是有效。如果遇到此问题，建议尝试移动节点，看看问题是否消失。
LSASL 道路折叠
在使用 LSASL 道路（工具中的一种样条类型）时，也可能出现类似问题。折叠可能会出现在各种转角角度下，且即使在较窄道路中也可能发生，但在更宽的道路上更为明显。
目前的解决方法，是调整转角角度 —— 可以适当增大或减小，如下图所示。
UV 贴图拉伸
有时渲染出的材质会出现拉伸现象。尤其是在使用某些跨路层类型时更容易出现。拉伸不仅受材质影响，也与材质所作用的表面宽度有关，因此即使是同一个材质也会有不同表现。
工具不知道每种可选贴图的合适长度，因此目前使用的是默认值（对于部分材质和宽度设置可能不合适）。
可以通过专用参数修改贴图长度。建议用户对长度参数进行调整，看看能否解决问题。一般来说，少许拉伸是可以接受的，无需数值完全精准。
倾斜道路出现异常弯曲
如果一条道路有较大的坡度，同时还向左或向右转弯（即绕 Z 轴），有时曲率可能显得不自然，甚至接近折叠。宽路面上尤为明显，但也可能出现在任何道路上，且常见于道路外侧部分。
如果遇到此问题，建议尽量减少道路的坡度和/或转弯角度（如条件允许）。
Z-Fighting（深度冲突）
在编辑可视化视图中，可能会发生 Z-Fighting（深度冲突）。比如本应在三角面片后方的线条却可见。这是因为某些情况下没有考虑摄像机的透视。该问题预计将在后续版本中修复。
编辑可视化的渲染方法最初仅用于调试，但后来用途扩展，问题也随之变得严重。
对网格（如桥梁）而言，用户有时会看到某些部位出现闪烁。这通常是因为两个网格完全重叠导致的。遇到这种情况，将一个网格稍稍移动通常可以解决问题。
浮雕路标下沉
已知当在网格上铺设浮雕（decals， 如边线、中心线等）道路时，若网格跨越较陡的悬崖地形，浮雕道路一般会出现在正确的道路表面，但有时会在下面陡坡地区出现金影。此外，还有可能部分浮雕路标未能正常贴合道路，而是“下沉”到地表或者下面的其他道路。此为已知问题，需要进一步调查。
桥梁（或任意其它网格）应适当加宽，边缘应超出所有可能铺设浮雕道路的位置，推荐宽出至少 30厘米左右。网格的起止端也同理。需要注意，这只是变通方法，并不能完全解决所有问题。
导入异常（仅 BeamNG.tech）
导入 OpenDRIVE 文件（.xodr）时，道路可能与预期（即与第三方 OpenDRIVE 查看器或类似工具中的表现）有所不同，这在道路连接处尤其明显。本工具采用线性插值平滑而不是直接裁切，后续还需进一步处理此问题。
其他导入问题可能出现，尤其是在处理较大或较复杂的 .xodr 文件时，比如道路宽度解析异常或其它渲染伪影。
还有一个导入相关的问题：内部仅支持最大道路半宽（中心线到道路边缘）为 30 米。一些 .xodr 文件包含超过此宽度的道路，将无法正确渲染。本工具还仅支持最多 20 条左侧车道和 20 条右侧车道，一些 .xodr 文件中的车道数超过此限时也无法正确导入。
这篇文章对你有用吗？
