工具

Osgearth提供了许多工具，帮助您处理地球文件和地理空间数据。

osgearth_viewer

osgearth_viewer可以从命令行加载和显示地图。OSGearth EarthManipulator用于控制摄像机，并针对查看地理空间数据进行了优化。

样品使用 ：：

osgearth_viewer earthfile.earth [options]

期权	描述
--sky	安装Skynode（仅限太阳、月亮、星星和大气层..Globe）
--kml [file.kml]	加载kml或kmz文件
--kmlui	显示用于切换kml放置标记和文件夹的有限用户界面
--coords	在鼠标下显示地图坐标
--ortho	安装正交摄影机投影
--logdepth	在高速模式下激活对数深度缓冲区。
--logdepth2	在高精度模式下激活对数深度缓冲区。
--uniform [name] [min] [max]	安装统一格式并显示屏幕上的滑块以控制其值。有助于调试。
--ico	激活OSG的incrementalcompileOperation，它将在一系列帧上编译分页对象（减少帧中断）。这实际上是一个openscegraph选项，但对osgearth有用

osgearth_version

osgearth_version 显示osgearth的当前版本。

论证	描述
--caps	打印系统功能
--major-number	仅打印出主要版本号
--minor-number	仅打印次要版本号
--patch-number	仅打印补丁版本号
--so-number	仅打印出共享对象版本号
--version-number	仅打印版本号

osgearth_cache

osgearth_缓存可用于管理osgearth的缓存。见 高速缓存 有关缓存的详细信息。osgearth_缓存最常见的用法是使用 --seed 争论。

样品使用 ：：

osgearth_cache --seed file.earth

论证	描述
--list	列出有关.earth文件中缓存的信息
--seed	在.earth文件中种子化缓存
--estimate	打印出估计的磁贴数量、磁盘空间和执行此种子操作所需的时间。
--mp	使用多处理来处理瓷砖。对于gdal源很有用，因为这样可以避免全局gdal锁
--mt	使用多线程处理图块。
--concurrency	如果提供了--mp或--mt，则使用的线程或进程数
--min-level level	种子的最低LOD级别（默认值=0）
--max-level level	种子的最高LOD级别（默认值=最高可用）
--bounds xmin ymin xmax ymax	地理空间边界框到种子（在地图坐标中；默认值=整个地图
--index shapefile	加载形状文件（.shp）并使用功能区设置缓存种子设定边界框。对于形状文件中的每个特征，添加一个边界框（类似于 --bounds ）限制要缓存的区域。
--cache-path path	重写.earth文件中的缓存路径
--cache-type type	重写.earth文件中的缓存类型
--purge	清除.earth文件中的层缓存

osgearth_conv

osgerath conv将一个tilesource的内容复制到另一个tilesource。所有参数都是配置名称/值对，因此需要在每个驱动程序的选项结构的头文件中查找选项。当然，输出驱动程序必须支持写入（通过实现readwritetilesource接口）。“in”属性来自gdaolOptions getconfig方法。“out”属性来自mbtileOptions getconfig方法。

样品使用 ：：

osgearth_conv --in driver gdal --in url world.tif --out driver mbtiles --out filename world.db

论证	描述
--in [name] [value]	设置输入属性的值
--out [name] [value]	设置输出属性的值
--elevation	转换为高程数据（而不是图像数据）
--profile [profile]	重新投影到目标配置文件，例如“wgs84”
--min-level [int]	要复制的最小详细级别
--max-level [int]	要复制的最大详细级别
--threads [n]	要使用的线程（小心，可能会崩溃。对gdal输入没有帮助）
--extents [minLat] [minLong] [maxLat] [maxLong]	lat/long扩展到copy

osgearth_package

osgearth_包创建一个可再发行的 TMS 基于地球文件的包。

样品使用 ：：

osgearth_package --tms file.earth --out package

论证	描述
--tms	进行TMS回购
--out path	tms repo的根输出文件夹（必需）
--bounds xmin ymin xmax ymax	包的边界（在地图坐标中；默认值=整个地图）可以提供多个边界
--max-level level	瓷砖的最大LOD级别（所有层；默认值为5）。注意：您可以将其设置为一个较大的数字以获取所有可用数据（例如99）。这对文件（如geotiff）很有用。但有些数据源没有报告（或具有）最大数据级别，因此最好指定一个特定的最大值。
--out-earth earthfile	导出引用新repo的接地文件
--ext extension	覆盖图像文件扩展名（例如JPG）
--overwrite	覆盖现有瓷砖
--keep-empties	写出完全透明的图像块（通常丢弃）
--continue-single-color	继续细分单色图块，细分通常在单色图像上停止。
--db-options	要以引号传递给图像编写器的db options字符串（例如，“jpeg_quality 60”）
--mp	使用多处理来处理瓷砖。对于gdal源很有用，因为这样可以避免全局gdal锁
--mt	使用多线程处理图块。
--concurrency	如果提供了--mp或--mt，则使用的线程或进程数
--alpha-mask	屏蔽不在规定范围内的图像。
--verbose	显示操作进度

osgearth_tfs

osgearth_tfs从诸如shapefile之类的功能源生成tfs数据集。通过将特性预处理到TFS提供的网格结构中，可以显著提高大型数据集的性能。此外，生成的TFS包可以由任何标准Web服务器提供服务，Web启用数据集。

样品使用 ：：

osgearth_tfs filename

论证	描述
filename	形状文件（或其他功能源数据文件）
--first-level level	将向四叉树添加功能的第一个级别
--max-level level	特征四叉树的最大级别
--max-features	每个图块的最大功能数
--grid	生成具有指定分辨率的单层网格。默认单位为米。（例如50、100公里、200英里）
--out	目标目录
--layer	要写入元数据文档的层的名称
--description	要写入元数据文档的层的摘要/描述
--expression	要在特定于要素源的要素源上运行的表达式
--order-by	如果表达式中尚未包含功能，请对其进行排序。追加降序说明！
--crop	作物特征而不是进行质心检查。启用裁剪时，可以将功能添加到多个瓷砖
--dest-srs	目标SRS字符串的任何格式都可以理解（wkt、proj4、epsg）。如果没有指定，将使用源数据SRS。

osgearth_backfill

osgearth_回填是用于后处理的专用工具 TMS 数据集。一些Web映射服务在不同的缩放级别使用不同的完全不同的数据集。例如，他们可以使用NASA的蓝大理石图像，直到达到4级，然后突然切换到陆地卫星数据。这对于二维滑动地图可视化很好，但在三维视图中可能会分散视觉，因为不同LOD的相邻瓷砖看起来完全不同。

osgearth_backfill允许您像通常那样生成一个tms数据集（使用osgearth_包或其他工具），然后从指定的更高细节级别“回填”较低的细节级别。例如，可以指定最大级别10，并且将根据级别10中的数据重新生成LOD 0-9。

样品使用 ：：

osgearth_backfill tms.xml

论证	描述
--bounds xmin ymin xmax ymax	回填边界（在地图坐标中；默认值=整个地图
--min-level level	停止回填的最低水平。（默认值=0）
--max-level level	开始回填的级别（默认值=inf）
--db-options	要以引号传递给图像编写器的db options字符串（例如，“jpeg_quality 60”）

osgearth_boundarygen

osgearth_boundarygen生成边界几何图形，可以将其与osgearth<mask>层一起使用，以便将外部模型粘贴到地形中。

样品使用 ：：

osgearth_boundarygen model_file [options]

论证	描述
--out file_name	边界几何图形的输出文件（默认为boundary.txt）
--no-geocentric	跳过地心重投影（用于平面数据库）
--convex-hull	计算凸壳而不是全边界
--verbose	将进度打印到控制台
--view	在三维窗口中显示结果
--tolerance N	小于此距离的顶点将合并（0.005）
--precision N	输出坐标将有这么多有效数字（12）

osgearth_overlayviewer

osgearth_overlayviewer 是一个实用程序，用于调试osgerth中的覆盖装饰器功能。它显示了两个窗口，一个窗口具有地图的法向视图，另一个窗口显示用于覆盖计算的边界截锥。