Files
AVA2/docs/TREE-RENDERING-2026-10-14.md

6.1 KiB
Raw Permalink Blame History

树木渲染与碰撞修复 — 2026-10-14

本批在 b3808d8d 之后修改客户端,参考本地 AVA2 SpeedTreeForestDirectX8.cpp、SpeedTreeWrapper.cpp、SpeedTreeForest.cpp、GameLib/MapUtil.cpp / MapOutdoor.cpp 和 EterLib/CollisionData.cpp。SDK、Windows 参考和服务器未修改。

修改位置

  • src/eter_render/SpeedTreeRT.h/.cpp:使用 SDK 实际 min/max(包含 authored 叶卡旋转余量)计算实例包围球中心、半径,支持当前场景 yaw/scale。默认无风模式允许共享静态树干/frond 顶点、法线、索引、UV 与 diffuse;通过实例 world 矩阵定位,叶片仍按相机及摇摆更新。模板只解析一次材质路径,减少每实例每帧的文件检查。树干与叶片/frond 均使用原版 GREATER / alpha=84,不再把树干当作没有透明测试的完全不透明网格。
  • src/eter_render/SpeedTreeForest.h/.cpp:视锥使用实际包围中心,距离裁剪只剔除整棵树冠都在距离之外的实例;CPU 风力选项用以原点为中心的保守球涵盖加权旋转。森林与实例分别维护风状态,取消未经原版定义的 ×0.05 换算。森林初始强度 0,实例 LoadTree 初始强度 1;不同环境强度更新现有实例,并保持叶片相位连续;相同强度 setter 不重复更新之后新建的实例,保留原版生命周期规则。
  • 同文件:新增 SPT 球体及有限圆柱的连续碰撞。使用 source XYZ→当前 engine XZY 和实例平移,按 Wrapper 的规则不额外旋转/缩放碰撞图元;CO_BOX 忽略。球相切使用严格 <,圆柱使用 <=,保留圆柱高度筛选。移动允许退出重叠,并补充两端在外的完整跨越检测,防止帧间跨过树干;飞行物使用无退出豁免的检测。无 authored 碰撞数据时不虚构树干障碍。
  • 同文件:真实资源加载失败不再伪装成程序化树;直接给定 .spt 名称时实际加载文件并使用 authored size,而不是按文件名生成无关树。仅没有真实资源声明的预览调用继续支持程序化树;拒绝非有限实例位置/yaw。
  • SpeedTreeRT.cpp 在模板加载时明确报告未完整解析的 token,保留 SDK 已恢复的元数据和 metadata_complete=false 状态,不通过跳过未知字节伪装为完整解析。
  • src/eter_render/MapObjectManager.h/.cpp:关联森林并用 weak lifetime 防止析构后访问;将树碰撞接到三维移动与飞行物查询。AreaData 的树加载失败不计为成功实例。
  • src/eter_render/ActorInstance.cpp:实际移动使用 BODY 球扫掠检测树木,缺少 BODY 的模型保留当前半径 30 的备用探针;点地移动最后一步也检测树木。原有建筑/地形及滑动路径继续使用。
  • src/eter_render/EnvironmentData.h、src/scripting/python_background.cpp:接通原版环境默认强度 0.2、森林初始化和环境切换;地图没有环境文件也能取得默认环境强度。
  • src/eter_render/Gr2ModelRenderer.cpp:软件 alpha test 改为纹理/顶点/材质 alpha 调制之后的 GREATER;reference 0 不再替换为 70;使用差值式插值,避免恒定 alpha=84 因浮点权重和误差变成略大于 84,和现有 GPU 管线统一。
  • tests/speedtree_forest_test.cpp:网格包围、yaw/scale 世界变换、部分树冠可见、130 实例共享一份树干流、CPU 模式切换、风强及相位连续、新实例与同值 setter、真实名称加载/失败、球/圆柱/忽略 box、高度/相切/高速跨越/退出重叠、角色阻挡、删除/析构后的查询。
  • tests/background_test.cpp:默认环境风强接通及原有帧步长回归。
  • tests/flying_target_test.cpp:软件透明阈值等于/大于 84、reference 0、透明片元不写深度、材质 alpha 调制之后再判断。
  • tests/hardware_scene_test.cpp:实际 GPU 像素回读核对纹理 alpha 84/85/0/1 的颜色与深度遮挡边界。

资源与验证

日志位于 build/verification/tree-rendering-2026-10-14/。使用 generation_baseline 对当前真实资源目录的 485 个 SPT 跑两次快照,包含所有 LOD 的顶点、索引、几何/pivot hash、包围范围、节点数和限制状态;两次几何与包围结果无变化,均无截断。这证明当前恢复实现的可重复性与本资源集的完整生成,不能证明与 Windows DLL 随机序列或树形等价。

额外元数据审计:205 个完全解析,280 个报告未知扩展 token 22000(已有 REVERSE-ENGINEERING 中的待办)。这些文件的已知主数据可生成几何,但 22000 及后续扩展没有恢复;生成无截断不能掩盖这一缺口。详见 metadata-summary.log 与 incomplete-metadata.jsonl。

共享树干流测试直接核对世界变换后顶点与原展开路径一致,以及 130 个实例复用相同几何指针;不把此结果当作手机 FPS 或耗电测量。

最终验证:完整构建通过;专项 6/6(6.82 秒);完整 CTest 62/62(48.61 秒);严格 ASan/UBSan 5/5(4.07 秒),含实际执行的 GPU alpha 像素回读,无跳过或执行路径诊断。Python C 代码未全部同等插桩。46 模块方法无缺失/占位,395 映射协议常量无不匹配/未匹配,git diff --check 通过。

剩余边界

完整树形/随机调用分布、叶片摆幅/绝对首帧时间、原 DLL 输出尚未动态对齐。本批维持原版全几何 LOD 行为,没有启用会改变画面的自动降级。当前共享静态几何能交给原有 SDL_GPU resident/实例管线;专用叶片 GPU placement/风力 shader 尚未接入,叶片仍由 CPU 更新。密集森林真机 FPS、CPU/GPU 时间和耗电仍待测量。

碰撞数据来自资源元数据,requested tree size 对原 DLL 返回图元的内部缩放仍缺少动态证据;本批按 Wrapper 可见的平移规则实现。自定义 yaw/scale 的画面与 source 不旋转/缩放图元规则可能不同,不能宣称这些扩展变换的碰撞完全贴合。完整动态球推开/滑动响应、矿石交互、空间 culling 候选顺序及不在本资源集内的资产仍待对照;缺少 BODY 时的探针是当前移植的备用方案。

以上改动未提交或推送;设备与原版实机画面对照尚未完成。