Refactor Cesium material export contract

This commit is contained in:
que01 committed 2026-08-03 11:52:38 +08:00
1 parent 50dc5f4e5a
commit 0635c09458
16 files changed
+583 -95

No files matched your search

@@ -55,8 +55,11 @@ Blender 高度与线性颜色。两侧靠 `catalog.check_layers()` 对账集合
Blender 内材质声明集中在 `catalog.MATERIALS`(`catalog.py:56`)。
真实 `bpy.types.Material` 由 `materials.from_spec()`(`materials.py:198`)构建。
注意当前有一个未完成迁移:`export_cesium.py:68`、`:80`、`:86`、`:95` 的四张表
仍按材质名字符串匹配。改材质名时不能只改 `catalog`;必须全仓 grep 材质名。
Cesium 导出调色也属于同一个材质声明:新场景把 `catalog.MATERIALS[*]["cesium"]`
序列化到 `material["cesium_export"]`,`export_cesium.py` 优先读这个属性。四张
`export_cesium.py` 材质名表仍存在,但只作为旧 `.blend` 的兼容回退。
改材质名时不能只改 `catalog`;必须全仓 grep 材质名,确认新契约和旧回退路径都合理。
---
@@ -155,4 +158,4 @@ Blender 内材质声明集中在 `catalog.MATERIALS`(`catalog.py:56`)。
| 低层脚本直接读 `config/areas/*.json` | 两层配置边界失效 |
| 只改一份 `parseArgs` 的语义 | 三个入口行为分裂 |
| 把要素模块裁剪逻辑挪到调用方 | 不同要素的越界处理开始漂移 |
| 只在 `catalog.CESIUM_EXPORT` 加导出覆盖 | 当前不会生效;导出器没读它 |
| 只改 `export_cesium.py` 的旧回退表,不写 `MATERIALS[*]["cesium"]` | 新 `.blend` 不会携带 Cesium 导出契约 |