que01
2139990818
tree_style 新增 apple（SpeedTree Red Delicious，4475 tris，alpha 抠图叶片 + 法线贴图）和 fattree（低面数卡通树，2238 tris，实体几何）。 高度改为按模型自身包围盒归一化到目标高度，树根落在 z=0，不再用魔数； 每棵树按序号做确定性抖动（缩放 ±14%、黄金角偏航、±3° 倾斜）， tree_row 采样高度全部相同，不抖动就是同一棵树盖章 156 次。 移除 polyhaven 样式和 island_tree_01 资产（76MB）+ ingest_tree.py： 该样式 append 的 *_LOD1 并不是完整的树，枝干只有 0.41 单位高，叶片是 挂在原点下方的平面簇，本是给源文件几何节点散布用的碎片。 Cesium 侧修三处： - make_export_material 把 Alpha 恒定写死为 1.0，叶片卡片整块导出，而 SpeedTree 图集抠掉的区域是纯黑，在 Cesium 里就是黑色色块。 - Blender 4.2 起 glTF 导出不再读 blend_method（仍可写但已失效，写 CLIP 读回来是 HASHED），改为从节点树推断 alpha 模式，alpha 直连 BSDF 会落到 BLEND。新增 materials.link_alpha_clip() 构造导出器识别的 1 - (alpha < cutoff) 结构，得到 alphaMode=MASK。 - 新增 alpha_dilated_image()：把不透明像素颜色向抠图区域外扩 8 圈， 避免 mipmap 把黑色平均进叶缘。叶缘相邻的纯黑像素 10.3% → 0.6%。 另修两个既有 bug： - 材质槽在 mesh 上，181 棵树共享一个 datablock，第一棵替换后其余会把结果 再包一层，产生 Cesium Cesium Cesium... 的材质名；烘焙图缓存按材质名索引， 每轮再嵌一份同样的贴图。GLB 22.46MB → 20.76MB，materials 270 → 23。 - shrub_02 从 glTF 带进来一个 Math 节点接在 Alpha 上，但其 JPEG 贴图 alpha 全是 1.0，只判断「连了 Alpha」会误判为抠图材质。 模型资产为第三方素材，已 gitignore，缺失时回落到 natural； 来源见 assets/models/SOURCES.md。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# Blender 3D 场景生成
|
||
|
||
该生成器将 OSM 建筑、水体、植被标签，以及可选的 osm2streets GeoJSON 道路图层，组合为 Blender 3D 场景。
|
||
|
||
项目主入口是根目录的区域管线：
|
||
|
||
```bash
|
||
npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages blender,cesium
|
||
```
|
||
|
||
下面的命令适合单独调试 Blender 脚本。
|
||
|
||
## 生成场景
|
||
|
||
```bash
|
||
/Applications/Blender.app/Contents/MacOS/Blender \
|
||
--background --factory-startup \
|
||
--python blender/generate_scene.py -- \
|
||
--osm "/path/to/input.osm" \
|
||
--geojson "/path/to/osm2streets_web_out" \
|
||
--output "/path/to/output.blend" \
|
||
--render "/path/to/preview.png" \
|
||
--tree-style natural
|
||
```
|
||
|
||
`--geojson` 为可选参数。不提供时，道路使用简单的 OSM highway 折线，而非详细 osm2streets 几何。实际资产生成建议先跑 `intermediates` 阶段，为 Blender 提供 osm2streets 道路面、标线、斑马线和箭头。
|
||
`--tree-style` 可选 `apple`、`fattree`、`natural`、`procedural`。
|
||
|
||
- `apple`（拟真）——SpeedTree Red Delicious，4.5k tris，叶片是 alpha 抠图卡片，带法线贴图。
|
||
- `fattree`（卡通）——低面数卡通树，2.2k tris，纯实体几何，无抠图。
|
||
- `natural`——低面数树干 + 多层不规则树冠，不依赖外部模型。
|
||
- `procedural`——最轻，球形树冠。
|
||
|
||
`apple` 和 `fattree` 依赖 `assets/models/` 下的第三方模型（已 gitignore）。模型缺失时自动回落到 `natural`，干净 checkout 仍可构建；实际使用的样式记录在场景的 `tree_style_used` 属性里。
|
||
|
||
使用 `--office-overrides` 指定一组 OSM way ID（逗号分隔），这些建筑将渲染为办公楼风格，即使其 OSM 标签为 `building=industrial`：
|
||
|
||
```
|
||
--office-overrides "117753521,117753535"
|
||
```
|
||
|
||
### 说明
|
||
|
||
- OSM `bounds` 元素定义场景范围（排除远处的地铁等关系成员）
|
||
- `natural=tree` 节点 → 独立树木（默认低面数自然树冠）
|
||
- `natural=tree_row` 路径 → 沿路径均匀分布的树木
|
||
- `landuse=grass` → 绿色地面
|
||
- `natural=scrub` → 低矮灌木丛
|
||
- `amenity=fountain` → 低多边形喷泉
|
||
- 建筑：`building=industrial` → 厂房风格；其他 → 办公楼风格（带窗带）
|
||
- 植被和建筑高度从 OSM `height` 标签读取
|
||
- 程序化细节（窗带、屋顶设备、树冠）不改变 OSM 体量
|
||
- 纹理使用 Poly Haven 的 1K CC0 纹理，打包在 `.blend` 内
|
||
|
||
## 导出为 Cesium GLB
|
||
|
||
```bash
|
||
/Applications/Blender.app/Contents/MacOS/Blender \
|
||
--background \
|
||
--python blender/export_cesium.py -- \
|
||
--blend "/path/to/output.blend" \
|
||
--glb "/path/to/output_cesium.glb" \
|
||
--metadata "/path/to/output_cesium.json"
|
||
```
|
||
|
||
GLB 使用以 OSM bounds 中心为原点的局部 ENU 坐标系（X 东，Y 北，Z 上）。
|
||
使用配套的 JSON 元数据文件将模型放置到 Cesium 中。
|
||
区域管线的 `cesium` 阶段还会在输出目录生成 `<area-id>-cesium-preview.html`。
|
||
|
||
导出脚本会：
|
||
- 应用网格修改器并创建 UV
|
||
- 将 Blender 特有材质转换为 glTF 兼容 PBR 材质
|
||
- 烘焙色调覆盖基础色以实现干净的 Web 渲染
|
||
- 将所有纹理图片嵌入 GLB
|
||
- 写入包含 WGS84 锚点和 Cesium JS 辅助代码的 JSON 元数据
|
||
|
||
### 预览
|
||
|
||
在输出目录上启动 HTTP 服务后打开预览页：
|
||
|
||
```bash
|
||
cd /path/to/output
|
||
python3 -m http.server 8765
|
||
```
|