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

38 lines
6.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 树木渲染与碰撞修复 — 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 时的探针是当前移植的备用方案。
以上改动未提交或推送;设备与原版实机画面对照尚未完成。