Adopt Shapespark vegetation assets
This commit is contained in:
@@ -0,0 +1 @@
|
||||
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
|
||||
@@ -0,0 +1 @@
|
||||
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
|
||||
47
.trellis/tasks/08-03-test-shapespark-tree-variants/prd.md
Normal file
47
.trellis/tasks/08-03-test-shapespark-tree-variants/prd.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# Test Shapespark tree variants
|
||||
|
||||
## Goal
|
||||
|
||||
Use the split Shapespark low-poly plant assets as tree, scrub bush, and lawn
|
||||
tuft variants, then validate `nantaizi-lake-innovation-valley`.
|
||||
|
||||
The user liked the Shapespark `bush-03` scrub replacement and wants to evaluate
|
||||
whether the same kit can replace the current tree asset. If multiple tree
|
||||
variants are not too expensive, the scene should use varied trees while staying
|
||||
deterministic for the same OSM input.
|
||||
|
||||
## Requirements
|
||||
|
||||
1. Prefer Shapespark tree assets from
|
||||
`assets/models/custom/shapespark_plants/tree-*/model.gltf`.
|
||||
2. Use deterministic variant selection based on stable tree instance ordering;
|
||||
do not use unseeded random or time-dependent randomness.
|
||||
3. Preserve existing tree placement count and route/road/building behavior.
|
||||
4. Preserve the existing scrub bush `bush-03` experiment.
|
||||
5. Replace the old Poly Haven `shrub_02` lawn tuft asset with suitable
|
||||
Shapespark grass assets.
|
||||
6. Evaluate the cost of loading multiple tree and lawn tuft variants:
|
||||
- number of shared tree meshes introduced
|
||||
- number of shared lawn tuft meshes introduced
|
||||
- texture/image/material counts
|
||||
- output GLB size
|
||||
- total nodes
|
||||
7. Rebuild only `nantaizi-lake-innovation-valley` stages
|
||||
`blender,cesium,preview`.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] Tree generation uses Shapespark tree variants deterministically.
|
||||
- [ ] Lawn tufts use Shapespark `grass-*` variants instead of `shrub_02`.
|
||||
- [ ] `python3 -m py_compile blender/generate_scene.py blender/osmassets/tree.py` passes.
|
||||
- [ ] `python3 -m unittest blender/tests/test_pure.py` passes.
|
||||
- [ ] nantaizi `blender,cesium,preview` rebuild passes.
|
||||
- [ ] GLB digest reports tree mesh/material/image/node cost.
|
||||
- [ ] User can open the local preview and compare visual result.
|
||||
|
||||
## Out Of Scope
|
||||
|
||||
- Runtime LOD.
|
||||
- hanyang validation.
|
||||
- Texture compression / KTX2.
|
||||
- Committing the experiment before user approval.
|
||||
99
.trellis/tasks/08-03-test-shapespark-tree-variants/report.md
Normal file
99
.trellis/tasks/08-03-test-shapespark-tree-variants/report.md
Normal file
@@ -0,0 +1,99 @@
|
||||
# Shapespark tree variant experiment report
|
||||
|
||||
## Current Trial
|
||||
|
||||
`nantaizi-lake-innovation-valley` now uses:
|
||||
|
||||
- scrub bush: `assets/models/custom/shapespark_plants/bush-03/model.gltf`
|
||||
- tree style: `shapespark`
|
||||
- Shapespark tree variants: 12 deterministic variants from
|
||||
`assets/models/custom/shapespark_plants/tree-*/model.gltf`
|
||||
- lawn tufts: 3 Shapespark grass variants from
|
||||
`assets/models/custom/shapespark_plants/grass-*/model.gltf`
|
||||
- Cesium export uses a gentler Shapespark foliage profile:
|
||||
`gain=1.12`, `saturation=1.0`, `emission=0.06`.
|
||||
|
||||
Variant selection is deterministic: it uses the stable tree instance index and
|
||||
the golden-turn sequence, not runtime random state.
|
||||
|
||||
## Validation
|
||||
|
||||
Commands run:
|
||||
|
||||
```bash
|
||||
python3 -m py_compile blender/generate_scene.py blender/osmassets/tree.py blender/export_cesium.py
|
||||
python3 -m unittest blender/tests/test_pure.py
|
||||
npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages blender,cesium,preview
|
||||
node scripts/glb-digest.js outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb --out /tmp/nantaizi-shapespark-tree-glb-digest.json
|
||||
node scripts/glb-digest.js outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb --out /tmp/nantaizi-shapespark-grass-glb-digest.json
|
||||
node scripts/glb-digest.js outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb --out /tmp/nantaizi-shapespark-toned-glb-digest.json
|
||||
node scripts/glb-digest.js outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb --out /tmp/nantaizi-shapespark-toned-rebuild.json
|
||||
node scripts/glb-digest.js outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb --out /tmp/nantaizi-shapespark-cleanup.json
|
||||
python3 ./.trellis/scripts/task.py validate .trellis/tasks/08-03-test-shapespark-tree-variants
|
||||
```
|
||||
|
||||
Results:
|
||||
|
||||
- `SCENE_DONE.tree_style`: `shapespark`
|
||||
- Trees planted: `197`
|
||||
- Grass tufts planted: `270`
|
||||
- Scrub bush nodes: `266`
|
||||
- GLB nodes: `830`
|
||||
- GLB meshes: `113`
|
||||
- GLB materials: `32`
|
||||
- GLB images: `18`
|
||||
- GLB accessors after final rebuild: `675` (accessor count is a known glTF
|
||||
exporter fluctuation and is ignored by parity)
|
||||
- GLB size after color tuning: `20.50 MB`
|
||||
- Shapespark tree mesh datablocks: `12`
|
||||
- Shapespark tree materials: `7`
|
||||
- Shapespark tree images: `7`
|
||||
- Shapespark tree shared geometry: `6,255` vertices / `18,696` indices
|
||||
- Shapespark lawn tuft mesh datablocks: `3`
|
||||
- Shapespark lawn tuft materials: `2`
|
||||
- Shapespark lawn tuft images: `2`
|
||||
- Shapespark lawn tuft shared geometry: `84` vertices / `90` indices
|
||||
|
||||
## Assessment
|
||||
|
||||
The multi-tree cost is acceptable for this scene. Tree node count stays the
|
||||
same because the implementation links shared mesh datablocks per instance.
|
||||
The extra cost is only 11 more shared tree mesh datablocks than a single tree
|
||||
variant, plus 7 tree texture/material entries. The total GLB is still smaller
|
||||
than the previous apple-tree build because the Shapespark textures and meshes
|
||||
are lighter.
|
||||
|
||||
Replacing the former Poly Haven `shrub_02` lawn tuft with Shapespark
|
||||
`grass-01/02/03` further reduces shared tuft geometry from a high-detail plant
|
||||
asset to only 3 tiny grass-card variants. The lawn tuft instance count stays
|
||||
the same, so the visual density is comparable while the shared geometry cost is
|
||||
effectively negligible.
|
||||
|
||||
The color issue came from reusing the apple-tree export profile for every
|
||||
alpha-cut plant. Apple needs strong albedo gain / saturation / emission because
|
||||
its atlas is unusually dark. Shapespark foliage does not; using the apple
|
||||
profile made it read yellow-green and glowing. The final trial keeps the
|
||||
alpha-mask cleanup but uses much lower exposure and emission for Shapespark
|
||||
material names (`branch-*`, `shrubbery-*`, `high-grass-*`, `hedge-*`,
|
||||
`clover-*`, `flowers-*`).
|
||||
|
||||
Compared with the pre-Shapespark scrub-density baseline (`31.96 MB` GLB), this
|
||||
trial is about `11.46 MB` smaller while keeping the same object count budget:
|
||||
`830` nodes, `197` trees, `270` lawn tufts, and `266` scrub bush instances.
|
||||
The main savings come from replacing the original heavy scrub bush, the
|
||||
high-detail lawn tuft asset, and the apple tree atlas with lighter shared
|
||||
Shapespark assets.
|
||||
|
||||
## Cleanup
|
||||
|
||||
After user visual approval, the old vegetation assets and their runtime loaders
|
||||
were removed:
|
||||
|
||||
- retired tree styles: `apple`, `fattree`
|
||||
- removed assets: SpeedTree apple, Lyrog fattree, Poly Haven `shrub_02`,
|
||||
original `custom/bush`, rejected `custom/bush_low`
|
||||
- remaining model tree style: `shapespark`
|
||||
- remaining external plant asset root:
|
||||
`assets/models/custom/shapespark_plants/`
|
||||
- nantaizi rebuild after cleanup stayed at `20.50 MB`, `830` nodes, `113`
|
||||
meshes, `32` materials, `18` images
|
||||
26
.trellis/tasks/08-03-test-shapespark-tree-variants/task.json
Normal file
26
.trellis/tasks/08-03-test-shapespark-tree-variants/task.json
Normal file
@@ -0,0 +1,26 @@
|
||||
{
|
||||
"id": "test-shapespark-tree-variants",
|
||||
"name": "test-shapespark-tree-variants",
|
||||
"title": "Test Shapespark tree variants",
|
||||
"description": "",
|
||||
"status": "in_progress",
|
||||
"dev_type": null,
|
||||
"scope": null,
|
||||
"package": null,
|
||||
"priority": "P2",
|
||||
"creator": "dingkang",
|
||||
"assignee": "dingkang",
|
||||
"createdAt": "2026-08-03",
|
||||
"completedAt": null,
|
||||
"branch": null,
|
||||
"base_branch": "main",
|
||||
"worktree_path": null,
|
||||
"commit": null,
|
||||
"pr_url": null,
|
||||
"subtasks": [],
|
||||
"children": [],
|
||||
"parent": null,
|
||||
"relatedFiles": [],
|
||||
"notes": "",
|
||||
"meta": {}
|
||||
}
|
||||
Reference in New Issue
Block a user