XCEngine/docs/api/XCEngine/Rendering/Passes/BuiltinInfiniteGridPass/BuildInfiniteGridParameters.md

BuildInfiniteGridParameters

InfiniteGridParameters BuildInfiniteGridParameters(const InfiniteGridPassData& data);

行为说明

当前实现会：

1. 拒绝 data.valid == false 的输入。
2. 以相机高度为主，计算目标网格间距。
3. 把目标间距吸附到最近的十进制尺度 10^n。
4. 计算向下一档网格过渡时的 transitionBlend。
5. 结合网格尺度和视线到地面距离，生成 fadeDistance。

当前特征

• 水平平移不会改变结果。
• 相机高度跨过阈值时，baseScale 会从 1 -> 10 -> 100 这类十进制级别跳变。
• orbitDistance 当前不参与参数推导。

测试覆盖

tests/Editor/test_scene_viewport_overlay_renderer.cpp 当前验证了：

• 间距始终落在十进制尺度上。
• 水平平移不影响参数。
• 相机高度升高会扩大网格尺度和淡出距离。
• transitionBlend 在阈值前后平滑过渡。
• orbitDistance 变化不会影响结果。

相关文档

• BuiltinInfiniteGridPass
• InfiniteGridPassData
• InfiniteGridParameters