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

摘要

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

使用情况

• 1.4 版本和更高版本的场景图层包可以转换为最新的 I3S 版本。

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

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

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

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

• 您可以使用创建云存储连接文件工具来构建连接文件 (.acs)。

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

参数

对话框

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

Python

arcpy.management.UpgradeSceneLayer(in_dataset, out_folder_path, out_name, {out_log}, {texture_optimization})

名称	说明	数据类型
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 Pro 客户端和 Windows、Linux 和 Mac 上的 ArcGIS Runtime 桌面客户端。 这是默认设置。 MOBILE—支持 Android 和 iOS 的纹理将进行优化，包括 JPEG 和 KTX2，可用于 ArcGIS Runtime 移动应用程序。 NONE—JPEG 纹理将进行优化，可用于桌面和 web 平台。	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")

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是