2.8 KiB
设计:LowPoly Cars 资产库
边界与目录
本任务独立于区域构建和 Cesium 预览。新增目录
assets/models/custom/lowpoly_cars/,其内部结构与 Shapespark 植物包一致:
lowpoly_cars/
manifest.json
index.html
textures/
<vehicle-id>/model.gltf
<vehicle-id>/model.bin
<vehicle-id>/preview.png
源 .blend 保留在用户 Downloads,不复制入仓库;manifest.json 保存源文件名与根对象名,
以便可追溯而不引入二进制源文件。
拆分与规范化
新 Blender 工具以 Empty 根节点和其全部后代 mesh 作为一辆车。根节点名是稳定初始 ID:
car_a01_002、truck_a01_001 等。名称重复的车辆保留全部条目,不依据几何统计猜测合并。
导出前把每辆车的根节点变换 bake 到其后代网格,再把局部原点置于车辆的水平中心和最低接地点。
规范化的预览坐标为 X 前进、Y 向上、Z 横向;若源根节点的朝向不符合它,工具按对象族显式
变换并由渲染缩略图复核。不能依赖源文件中用于陈列的全局坐标、0.001 缩放或 90°/180°旋转。
保留同一辆车的 mesh 分件与材质槽,避免为图库的便利合并导致窗、轮胎等材质丢失。图像依赖
集中复制到 textures/,glTF 以相对路径引用,重复车款不能复制同一张贴图。
产物与预览
工具为每辆车导出 glTF/bin,使用隔离的三点布光、地面阴影与固定透视相机输出
preview.png。index.html 只消费 manifest,响应式显示缩略图、ID、类别、三角面数、尺寸和
材质;它不依赖 Cesium、Node 打包或区域输出,通过 HTTP 直接查看。
manifest.json 的每项至少包含 id、name、category、sourceRoot、model、bin、
preview,以及 metrics.vertices、metrics.triangles、metrics.dimensions、
metrics.materials。category 取 car、truck 或 tractor。
风险与回退
Blender 的沙箱内加载会崩溃,因此导出、渲染和检查仅通过受批准的沙箱外 Blender 调用。若
某一根节点导出失败,工具记录错误并继续其余资产;manifest 只收录有效产物,失败根节点写入
报告。删除 lowpoly_cars/ 不影响任何当前构建阶段或 Cesium 巡航。
Cesium 候选集
候选集固定为 car_a01_002、car_a02_002、car_a03_001,以及按稳定 ID 排序的前三辆
卡车 truck_a01_001、truck_a02_001、truck_a03_001。预览构建把这六个 glTF/bin 与一张
共享 512px 贴图复制到区域输出目录并改写其 image URI;浏览器页面加载时从文件名列表随机选
一项,所有巡航实体在本页使用相同模型。这样构建产物保持确定,随机性只属于用户可见的会话。