升级场景图层 (数据管理)

摘要

用于将场景图层包升级为 SLPK 格式的当前 I3S 版本,或输出到 i3sREST 格式以用于 ArcGIS Enterprise

使用情况

  • 1.4 版本和更高版本的场景图层包可以转换为最新的 I3S 版本。 可以在图层属性选项卡上找到场景图层的 I3S 版本。

  • 目前不支持点云场景图层

  • 使用纹理优化参数可以在输出场景图层包中添加或移除纹理。

  • 升级过程中遇到的警告可能会在工具消息或输出日志文件中进行报告。 警告不会影响场景图层包的显示,但可能指示不符合 I3S 规范

  • 使用目标云连接参数将场景图层内容输出到位于云中的对象存储,例如 Amazon S3Azure Blob 存储、Alibaba OSSGoogle Cloud。 可将此内容发布为场景服务,并且您选择的位置必须在 ArcGIS Enterprise 中注册为用户管理数据存储

  • 此工具不会修复 I3S 规范中缺少或不正确的所需属性的场景图层包。 错误将写入输出日志文件参数值。

  • 可以将“时区”环境与日期格式参数一起使用,以对输出场景图层包中的日期字段进行正确编码。 有关在场景图层上启用时间的详细信息,请参阅启用时间的场景图层

参数

标注说明数据类型
输入数据集

输入场景图层包。

File
输出文件夹

将在其中创建输出场景图层包的位置,或要输出到 i3sREST 格式的云连接文件 (.acs)。

Folder
输出名称

输出场景图层名称。

String
输出日志文件
(可选)

用于汇总评估结果的输出日志文件。

File
纹理优化
(可选)

指定根据使用场景图层包的目标平台优化的纹理。

警告:

可能需要大量时间来处理包括 KTX2 的优化。 要获得最快结果,请使用桌面选项。

  • 全部所有用于桌面、Web 和移动平台的纹理格式都将进行优化,包括 JPEG、DXT 和 KTX2。
  • 桌面支持 WindowsLinuxMac 的纹理都将进行优化,包括 JPEG 和 DXT,可用于 Windows 上的 AllSource 客户端和 WindowsLinuxMac 上的 ArcGIS Runtime 桌面客户端。 这是默认设置。
  • 移动支持 AndroidiOS 的纹理将进行优化,包括 JPEG 和 KTX2,可用于 ArcGIS Runtime 移动应用程序。
  • JPEG 纹理将进行优化,可用于桌面和 web 平台。
String
日期格式
(可选)

场景图层日期字段中日期值的格式。 如果未遇到任何日期字段,则将隐藏此参数。

String

arcpy.management.UpgradeSceneLayer(in_dataset, out_folder_path, out_name, {out_log}, {texture_optimization}, {date_format})
名称说明数据类型
in_dataset

输入场景图层包。

File
out_folder_path

将在其中创建输出场景图层包的位置,或要输出到 i3sREST 格式的云连接文件 (.acs)。

Folder
out_name

输出场景图层名称。

String
out_log
(可选)

用于汇总评估结果的输出日志文件。

File
texture_optimization
(可选)

指定根据使用场景图层包的目标平台优化的纹理。

警告:

可能需要大量时间来处理包括 KTX2 的优化。 要获得最快结果,请使用 DESKTOPNONE 选项。

  • ALL所有用于桌面、Web 和移动平台的纹理格式都将进行优化,包括 JPEG、DXT 和 KTX2。
  • DESKTOP支持 WindowsLinuxMac 的纹理都将进行优化,包括 JPEG 和 DXT,可用于 Windows 上的 AllSource 客户端和 WindowsLinuxMac 上的 ArcGIS Runtime 桌面客户端。 这是默认设置。
  • MOBILE支持 AndroidiOS 的纹理将进行优化,包括 JPEG 和 KTX2,可用于 ArcGIS Runtime 移动应用程序。
  • NONEJPEG 纹理将进行优化,可用于桌面和 web 平台。
String
date_format
(可选)

场景图层日期字段中日期值的格式。 如果未遇到任何日期字段,则将隐藏此参数。

String

代码示例

UpgradeSceneLayer 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用 UpgradeSceneLayer 函数将场景图层包升级到对象存储中,以供 ArcGIS Enterprise 发布工作流使用。

import arcpy
arcpy.management.UpgradeSceneLayer(r"C:\temp\buildings.slpk, 
                                   r"C:\CloudConnections\AWS.acs", 
                                   "buildings_upgraded", 
                                   r"C:\temp\extracted\out.json", "DESKTOP")
UpgradeSceneLayer 示例 2(Python 窗口)

以下 Python 窗口脚本演示了如何使用 UpgradeSceneLayer 函数升级场景图层包。

import arcpy
arcpy.management.UpgradeSceneLayer(r"C:\temp\buildings.slpk, r"C:\packages", 
                                   "buildings_upgraded",  
                                   r"C:\temp\extracted\out.json", "NONE")

环境