que01/osmWorkflow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
181 Commits 4 Branches 0 Tags
9bb97d45076f4ae7fa8c529ef7e54e1b832956cd
Commit Graph

181 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
que01
2832383f6e Add GLB stage manifests 2026-08-04 09:45:51 +08:00
que01
b7b5530430 chore: record journal 2026-08-04 09:16:50 +08:00
que01
c4d4bf9db2 chore(task): archive 08-04-add-area-diagnostics 2026-08-04 09:16:38 +08:00
que01
d4c3baf608 Add area diagnostics command 2026-08-04 09:16:14 +08:00
que01
78cb69edb6 chore: record journal 2026-08-03 18:15:55 +08:00
que01
99138d1eaf chore(task): archive 08-03-fix-osm-multipolygon-buildings 2026-08-03 18:15:44 +08:00
que01
95f8458ad2 Fix OSM multipolygon buildings 2026-08-03 18:15:22 +08:00
que01
37fe65b7ca chore: record journal 2026-08-03 17:50:53 +08:00
que01
96bafe9d6c chore(task): archive 08-03-experiment-glb-compression 2026-08-03 17:50:41 +08:00
que01
7ba85946dc Add optional GLB compression stage 2026-08-03 17:50:21 +08:00
que01
5ef128c6f9 chore: record journal 2026-08-03 17:11:10 +08:00
que01
1fe1af6874 chore(task): archive 08-03-test-shapespark-tree-variants 2026-08-03 17:10:49 +08:00
que01
dbb5705d8e Adopt Shapespark vegetation assets 2026-08-03 17:10:17 +08:00
que01
cd9cde0127 chore: record journal 2026-08-03 15:55:19 +08:00
que01
e58a92803d Record rejected low-poly bush experiment 2026-08-03 15:55:06 +08:00
que01
54b698746f chore(task): archive 08-03-use-low-poly-scrub-bush 2026-08-03 15:54:49 +08:00
que01
1a704e6e51 chore: record journal 2026-08-03 15:18:13 +08:00
que01
ae69404d59 chore(task): archive 08-03-smooth-cesium-preview-vehicle-cruise 2026-08-03 15:18:01 +08:00
que01
0d2dc2228c Improve Cesium cruise smoothness 2026-08-03 15:17:51 +08:00
que01
a824bee69b chore: record journal 2026-08-03 14:20:44 +08:00
que01
4623c65d50 chore(task): archive 08-03-clean-tuft-density-comment 2026-08-03 14:20:38 +08:00
que01
f569d45e74 Clean stale tuft density comment 2026-08-03 14:20:18 +08:00
que01
a6be274ced chore: record journal 2026-08-03 14:03:08 +08:00
que01
ca4385a8f5 chore(task): archive 08-03-design-feature-registry 2026-08-03 14:02:57 +08:00
que01
ff18217af5 Add feature registry dispatch 2026-08-03 14:02:28 +08:00
que01
dd50d3aae3 chore: record journal 2026-08-03 13:39:37 +08:00
que01
c2b7ea0d2d chore(task): archive 08-03-extract-road-module 2026-08-03 13:39:21 +08:00
que01
0f3c1ee635 Refactor road assembly module 2026-08-03 13:39:05 +08:00
que01
64517993e9 chore: record journal 2026-08-03 12:52:35 +08:00
que01
991f64f69b chore(task): archive 08-03-extract-building-module 2026-08-03 12:52:26 +08:00
que01
032922ae99 Refactor building assembly module 2026-08-03 12:52:10 +08:00
que01
bd392becb4 chore: record journal 2026-08-03 12:36:21 +08:00
que01
8b1dc48ad3 chore(task): archive 08-03-extract-fountain-module 2026-08-03 12:36:11 +08:00
que01
627105555f Refactor fountain assembly module 2026-08-03 12:35:51 +08:00
que01
168f57a8e8 chore: record journal 2026-08-03 12:13:18 +08:00
que01
1e21e7fae2 chore(task): archive 08-03-archive-refactor-plan 2026-08-03 12:13:08 +08:00
que01
68829214fb docs: Archive osmassets refactor plan 2026-08-03 12:12:49 +08:00
que01
0b8195b43f chore: record journal 2026-08-03 11:53:16 +08:00
que01
9ef9b8c67d chore(task): archive 08-03-material-export-contract 2026-08-03 11:53:02 +08:00
que01
0635c09458 Refactor Cesium material export contract 2026-08-03 11:52:38 +08:00
que01
50dc5f4e5a chore: record journal 2026-08-03 10:57:06 +08:00
que01
a6c79cb510 chore(task): archive 00-bootstrap-guidelines 2026-08-03 10:56:56 +08:00
que01
4c5981c555 Initialize Trellis project guidelines 2026-08-03 10:56:21 +08:00
que01
7f4ebe8fb7 Improve Cesium preview loading state 2026-07-31 18:11:21 +08:00
que01
0def373c09 Extract Cesium preview assets 2026-07-31 16:56:22 +08:00
que01
41a07a78ef Add scrub edge bushes 2026-07-31 16:53:28 +08:00
que01
eb4a0d9b2a fix: 树发黑的真正原因是反照率没提亮，并加饱和度让远看更绿 
emissive 提到 0.8 仍然发黑：它乘的是本来就很暗的反照率，0.8 × 深绿约等于
sRGB [0.22, 0.31, 0.11]，还是暗的。要提的是反照率本身。

Cesium 截图定位：草亮黄绿、建筑近白、路面浅灰，只有树暗。这棵树图集的叶片
本来就是深绿（绿色系像素均值 sRGB [0.249, 0.35, 0.12]），按真实反照率渲染
是对的，但场景里其他材质都被手工提亮过——EXPORT_TINTS 草 0.72、带肋墙面
0.86，EXPORT_EMISSION_OVERRIDES 建筑 0.18，全是针对 Cesium 偏白的默认光照
调出来的。新资产没调过，是唯一如实渲染的东西，放旁边就显得发黑。

- FOLIAGE_ALBEDO_GAIN = 2.1，在抠图植被 dilate 那一遍顺带乘上。用增益而非
  tint：其他材质是单一表面，而这是同时装着叶片/树皮/果实的图集，往绿色混会
  把树干染绿。缩放保留色相关系，只把整体抬到和邻居一样的曝光。
- FOLIAGE_SATURATION = 1.75，绕各像素自身 Rec.709 亮度做饱和度拉伸。图集本
  来就偏灰（平均饱和度 0.22），远看时 mip 把叶片、树皮、缝隙混在一起会更往
  中性靠。绕亮度拉伸把叶片推绿而基本不动本来中性的部分，也没有绿色 tint 强
  加给树干的色相偏移。叶片 sRGB → [0.262, 0.529, 0.021]，饱和度 0.22 → 0.34，
  过曝到纯白的像素占 0.3%。
- FOLIAGE_EMISSION 回调 0.25，它只负责给背光面兜底。
- 新增 triangulate_mesh()：export_tangents 打开后刷了 55 行「切向空间只能只算
  三角/四边形」，MeshBatch 建的 OSM 轮廓都是 n-gon。glTF 只有三角形，导出时
  无论如何都会三角化，提前做不改变任何输出三角形（三角数 51719 前后一致），
  切线 49/102 → 102/102，警告归零。

被数据排除的假设：贴图颜色全链路逐位一致；模拟 mip 链可见像素亮度
0.127→0.124；法线贴图抠图区是干净平面法线；GLB 重新导入 Blender 渲染正常。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-31 13:23:44 +08:00
que01
afada31469 fix: 树在 Cesium 远看发黑 — 补 emissive 并导出切线 
黑色色块修掉后仍存在：近看正常，远看整棵树是暗色块。逐项排除：

- 贴图颜色全链路无偏移，源 4k / 降采样 2k / GLB 内 PNG 的 opaque 均值
  都是 sRGB [0.409, 0.406, 0.362]，不是 gamma 问题。
- 模拟 GPU mip 链，可见像素亮度 mip0→mip6 只从 0.127 变到 0.124，
  覆盖率稳定 0.42，不是 mipmap 变暗。
- 法线贴图抠图区域是干净的平面法线 [0.494, 0.512, 0.988]，无黑像素。

真实原因是缺 emissive 补偿。预览页 skyBox / skyAtmosphere / sun 全部关闭
且未配置环境贴图，Cesium 只剩很弱的默认球谐环境光，太阳直射不到的面接近
全黑——这正是 EXPORT_EMISSION_OVERRIDES 存在的原因（建筑 0.18，程序化树冠
0.015~0.02）。树冠绝大部分是背光叶片卡片，远看塌成一团暗色，近看能看到
向阳面所以还行。apple 材质不在那张表里。

- 抠图植被把 diffuse 接回 Emission Color，FOLIAGE_EMISSION = 0.22。
  用带贴图的自发光而非平坦颜色：常量会把树干染成叶子绿，而这样每个像素
  下限是自身反照率的一个比例。不增加字节，emissiveTexture 指向 base color
  已在用的同一张图。
- 打开 export_tangents：apple 有法线贴图但图元无 TANGENT，缺失时切线由
  渲染器推导，在双面薄片叶子卡上不可靠。49/102 图元带上切线，顺带修正
  建筑法线贴图，GLB +0.83MB。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-31 12:00:06 +08:00
que01
2139990818 feat: 树渲染改用 apple/fattree 模型，修复 Cesium alpha 抠图丢失 
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>
 2026-07-31 11:30:16 +08:00
que01
b35b094ed2 docs: changelog 更新 — P0-P3 refactor + island_tree_01 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-30 09:22:04 +08:00