生成场景瓦片

使用说明

该工具支持基于指定工作空间中的指定场景生成S3M瓦片，并将结果保存到指定存储路径中。执行成功后，通常会在指定存储路径下以场景名称命名的文件夹内生成：

  • 一个以指定场景名称命名的工作空间文件（如 .smwu）；
  • 若干S3M瓦片文件夹（每个图层对应一个文件夹）；
  • 新工作空间中会包含一个同名场景，场景内加载了所有新生成的S3M瓦片图层，并保留各图层的风格信息。

该工具暂不支持基于场景中的地图图层、模型数据集、LAS数据集、KML图层生成S3M瓦片。如果场景中存在影像和地形图层，不会生成对应的影像瓦片和地形瓦片。

2026 Update1版本开始提供本工具。

参数说明

参数名 参数释义 参数类型
工作空间路径: 输入待生成场景瓦片的工作空间路径。 String
场景名称:
（可选）		 待生成瓦片的场景名称。为空时默认使用工作空间中的第一个场景；若设置的场景不存在，则生成失败。 String
存储路径: 输入结果数据的存储路径。 String
S3M版本:
（可选）		 设置结果 S3M瓦片数据的版本。默认值为S3M 3.01。可选项包括：
  • S3M 3.0：地理坐标系采用椭球体基准。支持MeshOpt压缩的顶点优化方式、支持KTX 2.0纹理压缩格式、支持OBB包围盒、PBR材质新增支持语义纹理和掩膜纹理、支持多种LOD切换模式、支持骨骼动画、支持表达更多维度的顶点属性、支持纹理像素级别的语义信息。
  • S3M 3.01：地理坐标系采用椭球体基准。在3.0基础上全面适配CH/T 9040行业标准，提供多种用于数据解析或格式转换的开放资源，升级属性数据存储结构（DB大文件），支持表达BIM构件树信息，支持表达多时序多要素特征值。
 S3MVersion
纹理压缩格式:
（可选）		 设置结果数据的纹理压缩格式。默认值为 DXTPC设备）。可选项包括：
  • WebP：PC与移动端通用，可减小文件体积和存储空间；但不降低显存占用。处理时间较短。
  • DXT(PC设备)：PC设备支持，可降低显存占用、提升渲染流畅度；但文件体积通常较WebP更大。处理时间较短。
  • CRN_DXT5（PC设备）：PC设备支持，文件体积比DXT更小，显存占用与DXT相同。处理时间较长。
  • KTX2.0：PC与移动端通用，可同时减小文件体积和显存占用，并可转码适配各平台/现代GPU格式。处理时间较长。
 CompressedTextureType
瓦片边长(m):
（可选）		 设置结果瓦片的边长，单位为米。默认值为0。 Double
属性存储类型:
（可选）		 设置结果属性数据的存储类型。默认值为S3MD。可选项包括
  • S3MD：以二进制流形式(内部主体内容为json格式）存储数据属性信息，能够快速提取单个对象的所有属性信息。
  • ATTRIBUTE：以二进制流的方式存储，具备更小的文件大小，能够快速提取多个对象指定字段的属性信息。
 AttributeExtentType
过滤阀值:
（可选）		 设置过滤阈值。默认值为 2.0。 Double
对象ID字段:
（可选）		 设置用于唯一标识对象ID的属性字段，默认值为SmID。由于该过程会对场景中所有满足条件的图层批量生成瓦片，因此只能统一设置一套字段，且该字段必须在所有满足条件的图层中都存在并保持一致。
如后续有瓦片更新需求，请使用SmUserID或其他唯一标识；不宜使用 SmID 等非唯一标识，以免更新失败。		 String

输出结果

参数名 参数释义 参数类型
场景瓦片工作空间路径 输出生成的场景瓦片工作空间路径，结果文件保存为“存储路径 + 场景名称 + 场景名称.sxwu”。 String