# 树模型资产来源

`assets/models/` 下的树模型是第三方素材，**已 gitignore**，不随仓库分发。
干净 checkout 缺这些文件时 `tree.assemble()` 返回 0，`generate_scene.py`
自动回落到 `natural` 样式，构建不会失败。

放置路径见 `blender/osmassets/tree.py` 顶部的常量。

## apple（`--tree-style apple`）

- 名称：RedDeliciousApple（SpeedTree 工具导出）
- 路径：`assets/models/speedtree/apple_low/`
  - `RedDeliciousApple.obj` — 4475 tris，单网格
  - `RedDeliciousApple.mtl` — 已重写，见文件内注释
  - `textures/apple_color_2k.png` — 由原始 4096² PNG 降采样，**必须保留 alpha 通道**，
    57% 的像素是抠掉的叶片卡片
  - `textures/apple_normal_2k.png` — 同上降采样

原始素材另有 `.fbx` / `.cgf` / `.st` / `.tif` 以及 `_SS` / `_Subsurface` 贴图，
管线不用，未收录。

降采样命令（原始 4k 贴图 16MB + 20MB，降到 2k 后 4.3MB + 4.7MB）：

```bash
sips -Z 2048 -s format png <原始>_Color.png  --out textures/apple_color_2k.png
sips -Z 2048 -s format png <原始>_Normal.png --out textures/apple_normal_2k.png
```

## fattree（`--tree-style fattree`）

- 名称：fat tree，作者署名 Lyrog（付费素材）
- 路径：`assets/models/lyrog/fattree/`
  - `fattree.blend` — 取其中名为 `fattree` 的对象，2238 tris
  - `textures/fat_tree.png` — 原文件名带空格（`fat tree.png`），已改为下划线

源 .blend 里的贴图路径是 `//fat tree.png`，只在原始目录下能解析；
运行时不依赖它，`tree.py` 会丢掉源材质并按上面的路径重建一个 Principled 材质。
该 .blend 里另有两个 `plant` 对象（灌木），管线未使用。

## 已移除

`polyhaven/island_tree_01`（76MB）已于 2026-07-31 删除，连同 `--tree-style polyhaven`
和 `blender/tools/ingest_tree.py`。原因见 `docs/changelog.md`：该文件的 `*_LOD1`
对象不是完整的树，而是给几何节点散布用的枝叶碎片。
若要重新取用，Poly Haven 上是 CC0：https://polyhaven.com/a/island_tree_01

`polyhaven/shrub_02` 仍在使用（草丛散布），不受影响。