Add GLB stage manifests

This commit is contained in:
que01 committed 2026-08-04 09:45:51 +08:00
1 parent b7b5530430
commit 2832383f6e
17 files changed
+579 -27

No files matched your search

+7 -6
View File
@@ -12,7 +12,8 @@
```
config/areas/<id>.json ← 你写的
│ build-area.js: normalizeAreaConfig() 补默认值 + 推导输出路径
│ scripts/lib/area-config.js: normalizeAreaConfig()
│ 补默认值 + 推导输出路径
▼
<areaDir>/_pipeline/osm2streets-qgis.config.json ← 生成的,不要手改
│
@@ -109,7 +110,7 @@ cp config/examples/template.json config/areas/my-area.json
}
```
⚠️ **给了就整体替换,不做逐字段合并**(`build-area.js:132`:`raw.osm2streets || {...}`)。
⚠️ **给了就整体替换,不做逐字段合并**(`raw.osm2streets || {...}`)。
只想改一个开关也必须把五个字段全写上,否则其余四个会退到 osm2streets 自己的默认值。
### `blender`
@@ -146,10 +147,10 @@ cp config/examples/template.json config/areas/my-area.json
}
```
可覆盖的键(`build-area.js:87-102`):`areaDir`、`fileStem`、`geojsonDir`、`gpkg`、
可覆盖的键(`scripts/lib/area-config.js`):`areaDir`、`fileStem`、`geojsonDir`、`gpkg`、
`qgisProject`、`qgisPreview`、`blend`、`render`、`glb`、`metadata`、`cesiumPreview`、
`compressedFileStem`、`compressedGlb`、`compressedMetadata`、`compressedCesiumPreview`、
`vehicleRoute`、`vehicleModel`、`pipelineDir`。
`vehicleRoute`、`vehicleModel`、`pipelineDir`、`stageManifestDir`。
**优先改 `fileStem` 或 `areaDir`**——它们能一次性影响全部派生路径。逐个覆盖容易漏。
@@ -157,11 +158,11 @@ cp config/examples/template.json config/areas/my-area.json
## 加一个配置字段
1. `normalizeAreaConfig`(`build-area.js:74`)里加进对应的分组,**用 `??` 不用 `||`**
1. `normalizeAreaConfig`(`scripts/lib/area-config.js`)里加进对应的分组,**用 `??` 不用 `||`**
(`false` / `0` 可能是合法值)
2. 只写两级 fallback:`raw.<group>?.<key> ?? 默认值`。
**不要**制造新的顶层平铺别名——那三级写法是历史兼容,不是模式
3. 若要传给低层脚本,加进 `writeDerivedConfig`(`:189`)的 `derivedConfig` 对象
3. 若要传给低层脚本,加进 `writeDerivedConfig` 的 `derivedConfig` 对象
4. 若是数值,在消费侧加 `Number.isFinite` + 范围校验,**在任何副作用之前**
5. 更新 `config/examples/template.json`
6. 更新本文档的字段表