Upgrade Scene Layer (Data Management)

Summary

Upgrades a scene layer package to the current I3S version in SLPK format or output to i3sREST format for use in ArcGIS Enterprise.

Usage

  • Version 1.4 and later scene layer packages can be converted to the latest I3S version.

  • Point cloud scene layers are not currently supported.

  • Use the Texture Optimization parameter to add or remove textures in the output scene layer package.

  • Warnings encountered during the upgrade process may be reported to the tool messages or the output log file. Warnings do not affect display of the scene layer package but may indicate noncompliance with the I3S specification.

  • Scene layer packages can be upgraded to either a folder in the file system or to an object store located in the cloud such as Amazon S3, Azure Blob storage, or Alibaba OSS. The location must be registered as a user-managed data store in ArcGIS Enterprise.

Parameters

LabelExplanationData Type
Input Dataset

The input scene layer package.

File
Output Folder

The location where the output scene layer package will be created, or the cloud connection file (.acs) to output to i3sREST.

Folder
Output Name

The name of the output scene layer.

String
Output Log File
(Optional)

The output log file that will summarize the results of the evaluation.

File
Texture Optimization
(Optional)

Specifies the textures that will be optimized according to the target platform where the scene layer package is used. Desktop includes Windows, Linux, and Mac platforms.

  • Desktop —Texture formats will be optimized for use in desktop and web platforms. Texture formats will be JPEG and DXT. This is the default.
  • None —Textures formats will be optimized for use in a desktop platform. The texture format will be JPEG.
String

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

The input scene layer package.

File
out_folder_path

The location where the output scene layer package will be created, or the cloud connection file (.acs) to output to i3sREST.

Folder
out_name

The name of the output scene layer.

String
out_log
(Optional)

The output log file that will summarize the results of the evaluation.

File
texture_optimization
(Optional)

Specifies the textures that will be optimized according to the target platform where the scene layer package is used. Desktop includes Windows, Linux, and Mac platforms.

  • DESKTOPTexture formats will be optimized for use in desktop and web platforms. Texture formats will be JPEG and DXT. This is the default.
  • NONETextures formats will be optimized for use in a desktop platform. The texture format will be JPEG.
String

Code sample

UpgradeSceneLayer example 1 (Python window)

The following Python window script demonstrates how to use the UpgradeSceneLayer function to upgrade scene layer packages to an object store that can be used in ArcGIS Enterprise publishing workflows.

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 example 1 (Python window)

The following Python window script demonstrates how to use the UpgradeSceneLayer function to upgrade scene layer packages.

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

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics