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

摘要

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

使用情况

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

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

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

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

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

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

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

参数

对话框

标注	说明	数据类型
输入数据集	输入场景图层包。	File
输出文件夹	将在其中创建输出场景图层包的位置，或要输出到 i3sREST 格式的云连接文件 (.acs)。	Folder
输出名称	输出场景图层名称。	String
输出日志文件 (可选)	用于汇总评估结果的输出日志文件。	File
纹理优化 (可选)	指定根据使用场景图层包的目标平台优化的纹理。 警告： 可能需要大量时间来处理包括 KTX2 的优化。 要获得最快结果，请使用桌面或无选项。 全部—所有用于桌面、Web 和移动平台的纹理格式都将进行优化，包括 JPEG、DXT 和 KTX2。 桌面—支持 Windows、Linux 和 Mac 的纹理都将进行优化，包括 JPEG 和 DXT，可用于 Windows 上的 ArcGIS AllSource 客户端和 Windows、Linux 和 Mac 上的 ArcGIS Maps SDKs 桌面客户端。 这是默认设置。 移动—支持 Android 和 iOS 的纹理将进行优化，包括 JPEG 和 KTX2，可用于 ArcGIS Maps SDKs 移动应用程序。 无—JPEG 纹理将进行优化，可用于桌面和 web 平台。	String
日期格式 (可选)	场景图层日期字段中日期值的格式。 如果未遇到任何日期字段，则将隐藏此参数。	String

Python

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 的优化。 要获得最快结果，请使用 DESKTOP 或 NONE 选项。 ALL—所有用于桌面、Web 和移动平台的纹理格式都将进行优化，包括 JPEG、DXT 和 KTX2。 DESKTOP—支持 Windows、Linux 和 Mac 的纹理都将进行优化，包括 JPEG 和 DXT，可用于 Windows 上的 ArcGIS AllSource 客户端和 Windows、Linux 和 Mac 上的 ArcGIS Maps SDKs 桌面客户端。 这是默认设置。 MOBILE—支持 Android 和 iOS 的纹理将进行优化，包括 JPEG 和 KTX2，可用于 ArcGIS Maps SDKs 移动应用程序。 NONE—JPEG 纹理将进行优化，可用于桌面和 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")

环境

时区