From 6bba34ee1eaa44982699e3cf2d2a782d57249bac Mon Sep 17 00:00:00 2001 From: FreeGIS Date: Mon, 29 Aug 2022 17:36:17 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9readme.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 9958e57..d271712 100644 --- a/README.md +++ b/README.md @@ -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) @@ -62,22 +64,25 @@ Arguments: Options: -v, --version 当前版本 - -s, --size 指定生成瓦片的尺寸（256 或 512）| 默认 512 像素 - -z, --zoom 指定瓦片的等级生成范围。例如，想生成 7 ~ 12 级的瓦片，则输入 -z 7-12 | 默认值是 -z 5-14 - -e, --encoding 指定瓦片的数据编码规则（mapbox 或 terrarium）| 默认 -e mapbox + -g, --epsg Tile适用坐标系，3857 | 4490 | 4326 (default: 3857) + -c, --clean 是否清空输出目录，0 | 1 (default: 0) + -s, --size 指定生成瓦片的尺寸,256 | 512 (default: 512) + -z, --zoom 指定瓦片的等级生成范围。例如，想生成 7 ~ 12 级的瓦片，则输入 -z 7-12 (default: "5-14") + -e, --encoding 指定瓦片的数据编码规则（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. 使用输出成果 @@ -114,7 +119,6 @@ map.addSource('my-custom-terrain', { - 扩展 gdal 驱动，使其支持 webp，直接生成 webp 格式的切片 - 重构核心模块，解耦，扩展使其支持生成 CesiumJS 支持的地形切片格式 - 重构核心模块解耦数据输出模块，升级支持生成 mbtiles -- 重构坐标系换算模块，支持生成自定义坐标系的瓦片，例如 `EPSG:4490` 和 `wgs-geodesic` 等 欢迎参与贡献，包括但不限于文档、功能扩展、性能优化！