Skip to content

Commit

Permalink
修改readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
FreeGIS committed Aug 29, 2022
1 parent 9dc0917 commit 6bba34e
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,10 @@
- 支持 `mapbox``terrarium` 两种地形瓦片编码格式供mapboxgl使用,其中terrarium格式是[tangram](https://www.mapzen.com/products/tangram/)引擎的官方地形格式,tangram是另外一款开源的webgl二三维一体化的引擎;
- 支持自定义瓦片级别和瓦片尺寸设置,瓦片周围会有 1px 的裙边。例如指定生成 512px 的瓦片,实际输出的瓦片文件分辨率为 `514 × 514`,与 Mapbox 官方一致;
- 自动读取数据源的坐标系统,重编码输入的 DEM 栅格文件,并重投影至 `EPSG:3857`(Web 墨卡托),然后生成瓦片;
- 支持适用于3857、4490、4326的地形切片生产;
- 内置了影像金字塔索引和多进程实现(暂未使用多线程),加速瓦片生成速度;
- 命令行提供了瓦片生成的进图条提示,便于用户查看生成进度。
- 内置一些异常导致的临时文件清理工作。

![生成进度条](./doc/progressbar.png)

Expand Down Expand Up @@ -62,22 +64,25 @@ Arguments:
Options:
-v, --version 当前版本
-s, --size <number> 指定生成瓦片的尺寸(256 或 512)| 默认 512 像素
-z, --zoom <number-number> 指定瓦片的等级生成范围。例如,想生成 7 ~ 12 级的瓦片,则输入 -z 7-12 | 默认值是 -z 5-14
-e, --encoding <string> 指定瓦片的数据编码规则(mapbox 或 terrarium)| 默认 -e mapbox
-g, --epsg <number> Tile适用坐标系,3857 | 4490 | 4326 (default: 3857)
-c, --clean <number> 是否清空输出目录,0 | 1 (default: 0)
-s, --size <number> 指定生成瓦片的尺寸,256 | 512 (default: 512)
-z, --zoom <number-number> 指定瓦片的等级生成范围。例如,想生成 7 ~ 12 级的瓦片,则输入 -z 7-12 (default: "5-14")
-e, --encoding <string> 指定瓦片的数据编码规则(mapbox 或 terrarium) (default: "mapbox")
-h, --help 帮助
```

可选参数说明:

- `-g`: 指定地形Tile适用坐标系,默认是适用3857坐标系;
- `-z`: 由于地形栅格数据通常是 90m、30m 的空间分辨率,等级太大意义不大,等级太低时起伏辨识也不高,所以默认生成中间的 `5-14` 级;
- `-s`: 指定输出瓦片的尺寸,默认是 512 像素;
- `-c`: 指定是否预先清理输出瓦片的存储目录,默认0,不清理;
- `-e`: 指定切片编码规则,默认 mapbox,用户可指定 terrarium 规则输出。

举例:

```bash
dem2terrain -z 4-15 -s 256 -e terrarium ./ZONE.tiff ./output
dem2terrain -z 4-15 -s 256 -e terrarium ./ZONE.tiff ./output -c 1 -g 3857
```

# 3. 使用输出成果
Expand Down Expand Up @@ -114,7 +119,6 @@ map.addSource('my-custom-terrain', {
- 扩展 gdal 驱动,使其支持 webp,直接生成 webp 格式的切片
- 重构核心模块,解耦,扩展使其支持生成 CesiumJS 支持的地形切片格式
- 重构核心模块解耦数据输出模块,升级支持生成 mbtiles
- 重构坐标系换算模块,支持生成自定义坐标系的瓦片,例如 `EPSG:4490``wgs-geodesic`

欢迎参与贡献,包括但不限于文档、功能扩展、性能优化!

Expand Down

0 comments on commit 6bba34e

Please sign in to comment.