加载倾斜摄影三维模型操作手册
使用说明
倾斜摄影三维模型能够全方位、全要素地展示现实物理世界，因其高精度、高效率、高真实感和低成本的绝对优势成为了三维GIS的重要数据来源。
SuperMap GIS 全系列产品支持倾斜摄影三维模型，并且为了优化模型在网络环境中的传输和解析，SuperMap iClient3D for WebGL/WebGPU采用三维瓦片（*.s3m）格式存储与发布模型数据，提高了浏览倾斜摄影三维模型的性能和效率。
本文档主要介绍SuperMap iClient3D for WebGL/WebGPU实现浏览倾斜摄影三维模型数据的详细操作流程，主要操作步骤如下：
其中涉及的产品有：SuperMap iDesktopX、SuperMap iServer、SuperMap iClient3D for WebGL/WebGPU。
操作流程
下面将以倾斜摄影三维模型数据MaSai为例进行详细介绍。
1、生成配置文件
生成配置文件功能可将存放在多个文件夹的多个*.osgb 格式的原始倾斜摄影三维模型生成一个 *.scp 格式的模型配置文件，它记录了倾斜摄影三维模型文件的相对路径、名称、插入点位置及坐标系信息等内容。
如果已有*.scp格式的配置文件，可跳过此步骤直接进行2、倾斜入库。
1.1操作步骤
（1）在 SuperMap iDesktopX 的三维数据选项卡中单击倾斜摄影组中的数据管理工具；展开功能列表后，单击生成配置文件按钮。
（2）在弹出生成倾斜摄影配置文件的对话框源数据处，设置以下：
- 源路径：单击右侧文件浏览按钮，在弹出的浏览文件夹对话框中选择 OSGB 数据所在文件夹，或者在文本框中直接输入 OSGB 数据所在的文件夹路径。
- 指定根节点：支持设置指定根节点。单击指定根节点按钮，弹出指定根节点对话框，显示文件路径，可以删除和增加根节点文件。系统会自动读取文件夹路径下所有根节点数据。
- 元数据：一个*.xml文件，文件里存储有数据的EPSG编码、插入点等信息。在此打开元数据，桌面会自动读取插入点和坐标系信息。
（3）在对话框的结果设置处，设置以下：
- 目标路径：选择 *.scp 文件保存路径；
- 目标文件名：输入 *.scp文件名称。默认名称为config。
（4）在对话框的模型参考点处设置X、Y、Z值。默认的模型参考点为（0,0,0）。
- 模型参考点是指倾斜摄影三维模型的中心点位置，X代表经度，Y代表纬度，Z代表高程。
（5）如果倾斜摄影三维模型是ENU坐标系，勾选ENU。或勾选投影设置，设置 *.scp 文件的投影信息，目前提供两种方式：
- 投影设置：当选择投影设置单选框，单击右侧设置...按钮，弹出坐标系设置对话框，选择一种投影作为目标文件的坐标系。
- 导入投影文件：当选择导入投影文件单选框，单击右侧文件浏览图标按钮，在弹出的选择窗口中，选择投影信息文件并导入即可。同时，下方文本框中会显示所选投影文件的坐标系详细信息。
（6）如果倾斜摄影三维模型需要进行坐标转换，勾选坐标转换参数设置复选框，设置目标坐标系和参照系转换设置。参数设置具体如下：
- 目标坐标系：设置坐标转换的目标坐标系，操作过程与投影设置一致，可参考步骤（5）。
- 参照系转换设置：设置转换方法和投影转换参数，其中转换方法通过单击右侧下拉箭头按钮进行选择。对于投影转换参数，单击设置按钮，弹出投影转换对话框，可进行详细参数设置。
（7）设置完以上参数后，单击确定按钮，即可执行生成配置文件操作。
详细操作，请参考 SuperMap iDesktopX 帮助文档生成配置文件。
1.2操作结果
操作完成后，目标路径下产生了一个*.scp的文件。
2、倾斜入库
上一步骤所生成的*.scp配置文件记录了倾斜摄影三维模型文件的相对路径、名称等信息，倾斜入库功能支持倾斜摄影三维模型数据进行重建LOD、纹理压缩、模型单体化以及修改模型中心点等操作，实现批量处理倾斜摄影三维模型，可实现倾斜算子一体化处理，支持多线程。
2.1操作步骤
（1）打开SuperMap iDesktopX，在三维数据选项卡倾斜摄影分组中点击数据处理工具；展开功能列表后，单击倾斜入库按钮。
（2）在对话框的源配置文件处，单击添加scp配置文件，在弹出的打开对话框中，选择 *.scp 文件，或者通过单击打开文件夹下所有scp文件按钮，添加源配置文件。
（3）主要参数设置说明如下：
- 输出目录：设置结果数据存放路径。
- S3M版本：支持四种S3M版本号，S3M1.0、S3M2.0、S3M3.0、S3M 3.01。如果使用的是10.21之前的WebGL包加载倾斜瓦片文件。则倾斜入库时建议使用S3M1.0。
- 线程数：设置倾斜入库操作的线程数，默认为8。
- 存储类型：如果是需要给倾斜摄影加密，存储类型必须选择紧凑型。如果将倾斜瓦片文件存储到MongoDB中，存储类型必须选择原始型。
- 顶点优化方式：目前提供3种压缩方式，压缩所需时间由短到长依次为，不压缩、Draco压缩，MeshOpt。
- 纹理压缩：目前支持4种压缩格式：WebP、DXT（PC设备）、CRN_DXT5（PC设备）、KTX2.0，默认为KTX2.0）。对于不同用途的数据，采用不同的纹理压缩方式，可以减少纹理图像所使用的显存数量。
- 中心点坐标单位：根据配置文件中心点坐标单位设置此参数。例如：原始配置文件中心点坐标单位为METER，则此参数选择米。
- 纹理重映射：用于解决部分数据中纹理拼接不合理的情况，提升性能，默认不勾选。
（4）在对话框的修改中心点：可选，勾选修改中心点后，设置模型中心点X、Y、Z坐标值。
- 倾斜摄影三维模型的坐标由配置文件（*.SCP）的标签和数据本身的坐标信息决定，加载同一测区的多份数据时，由于每份数据都有一个自己的中心点坐标，因此需要分别加载多个SCP配置文件。
- 修改模型中心点通过修改数据本身的坐标信息，用于解决同一测区的倾斜摄影三维模型数据多个中心点的问题，实现一个SCP配置文件加载所有数据的要求，不仅如此还支持多个模型批量修改中心点。
（5）在对话框的重建LOD：勾选重建LOD后，设置重建指数。重建指数是用于设置合并次数，默认值为1，系统会按4^n个块重建为一个块文件。勾选融合边界后，可以减弱倾斜摄影三维模型数据瓦片之间的交界效果，主要是针对瓦片边界存在少量相交的倾斜摄影三维模型数据。
（6）重建类型：重建所有层级是用于原始OSGB倾斜摄影三维模型重建层级。仅重建顶层是针对重建后顶层效果不好的S3MB数据，重新指定较精细层数据为新的根节点，再重建顶层。
（7）在对话框的模型单体化:可选，勾选模型单体化后，设置叠加到模型上的矢量面所在的数据源、数据集和目标字段。详细操作可参考SuperMap iDesktopX帮助文档压缩并单体化。
（8）投影设置目前提供两种方式：
- 投影设置：获取或设置数据的原始坐标系。当选择投影设置单选框，单击右侧设置...按钮，弹出坐标系设置对话框，选择一种投影作为目标文件的坐标系。详细操作可参考SuperMap iDesktopX帮助文档投影设置。
- 导入投影文件：当选择导入投影文件单选框，单击右侧文件浏览按钮，在弹出的选择窗口中，选择投影信息文件并导入即可。同时，下方文本框中会显示所选投影文件的坐标系详细信息。
详细操作可参考以下 SuperMap iDesktopX 帮助文档：
（9）设置完以上参数后，单击确定按钮，等待倾斜入库完成。
详细操作，请参考 SuperMap iDesktopX 帮助文档倾斜入库。
2.2操作结果
倾斜入库操作结果如下图-右S3MB所示，此次列举设置不重建LOD，生成了与原始文件结构一致的目标文件夹；分别打开任一模型文件夹，可以看到OSGB格式模型与S3MB格式模型的一一对应关系。
图1
3、发布服务
在上一步操作中对倾斜摄影三维模型进行了倾斜入库操作，接下来将倾斜摄影三维模型以三维服务的形式发布到本地或远程服务器上，实现Web网络资源共享。
3.1操作步骤
（1）在 SuperMap iDesktopX 桌面产品的工作空间管理器中，在场景下右键点击新建球面场景。
（2）图层管理器下选中普通图层，右键点击添加三维瓦片图层，选择*.scp配置文件。
（3）加载数据后，直接保存场景和工作空间。
（4）保存工作空间后，在 %SuperMap iServer_HOME%/bin 目录下，点击startup.bat批处理文件，启动SuperMap iServer服务。
（5）打开浏览器，地址栏输入http://localhost:8090/iserver/manager 进入服务管理页面，首页下点击快速发布一个或一组服务按钮。
（6）弹出快速发布服务-选择发布的数据来源对话框，在数据来源处选择工作空间，点击下一步。
（7）弹出快速发布服务-配置数据对话框，点击远程浏览按钮选择前述所保存的工作空间，点击下一步。
（8）弹出快速发布服务-选择发布的服务类型对话框，勾选REST-三维服务，点击下一步。
至此，服务发布已配置完成，按照提示点击完成和关闭按钮。
由于SuperMap iServer 支持将 S3M 瓦片、OSGB 模型瓦片 、地形瓦片(cf、terrainz)、影像瓦片(WebP、JPG、PNG)作为数据来源直接发布为三维服务。
详细操作，请参考SuperMap iServer帮助文档：
3.2操作结果
服务发布完成后，将在服务列表中显示该三维服务。
4、在SuperMap iClient3D for WebGL/WebGPU中加载
发布三维服务后，在此步骤中便可通过SuperMap iClient3D for WebGL/WebGPU浏览地形数据。
提示：在操作前请将SuperMap iClient3D for WebGL/WebGPU产品包存放在 SuperMap iServer_HOME /webapps 路径下。
4.1操作步骤
（1）获取三维数据url地址，按照如下顺序点击获取：
- 进入服务列表页面（http://localhost:8090/iserver/services），找到并点击上一步骤所发布的三维服务。
- 进入根目录页面，点击realspace；
- 进入三维服务根节点(3D)页面，点击datas。
- 进入三维数据列表(datas)页面，点击Config。
- 进入三维数据资源(data)页面，点击获取三维数据的配置文件，复制浏览器地址栏的url地址。
（2）进入产品包存放路径（ SuperMap iServer_HOME /webapps），在examples文件夹下，文本方式打开S3MTiles.html范例。
- 修改scene. addS3MTilesLayerByScp ()函数：将地址修改为方才复制的url地址，并更改name。
- 修改SuperMap3D.Cartesian3.fromDegrees()函数：它的参数为倾斜摄影三维模型的中心点位置，分别为经度、纬度和高程。请更改为*.scp文件中的插入点坐标，用于飞行定位到倾斜摄影三维模型位置。
（3）以localhost方式打开S3MTiles.html网页。
4.2操作结果
打开网页后，相机飞至倾斜摄影三维模型所在位置，显示效果如下图：
图2