Files
osmWorkflow/.trellis/tasks/archive/2026-08/08-05-cesium-preview-controls/design.md

1.7 KiB
Raw Blame History

设计Cesium 语义资产检查

边界

Blender 场景已按集合组织要素。Cesium 导出器在不修改作者场景的前提下,复用现有导出材质处理,先生成完整主 GLB再按集合筛选对象生成道路、建筑、植被和水体四份辅助 GLB。主 GLB 继续是默认资产和兼容基线。

资产契约

metadata 保持现有 asset 字段指向主 GLB并将 assets 扩展为:

  • main:完整场景,默认启用;
  • roadsbuildingsvegetationwater:语义检查资产,默认关闭。

每个资产提供稳定的 id、中文 labeltype: model、相对 urlenabled。旧 metadata 缺少这些额外资产时,预览按现有单资产回退路径加载。

预览交互

主场景模式只显示主 GLB并保留现有 Scene 总开关。切入分类检查模式时隐藏主 GLB、显示四个类别复选项选择类别时加载并显隐对应资产。离开分类模式后恢复主场景避免完整模型和类别模型重叠渲染。

控制面板继续是贴边的紧凑工具面,不添加嵌套卡片。模式切换使用分段控件,类别开关按一行标签排列;窄屏时自然换行。颜色只用于状态和可访问性反馈,不做大面积装饰。

兼容与回滚

主 GLB、主 metadata 和既有预览文件名均不变。任意辅助 GLB 缺失时,预览记录该资产失败但完整场景仍可加载。回滚只需恢复旧 exporter/runtime主产物仍可使用。

风险

多次导出会增加 Cesium 阶段耗时与磁盘占用,但只影响验证辅助产物,不改变主 GLB。导出时需确保每份辅助资产保留与主 GLB 相同的局部 ENU 坐标和材质处理。