Skip To Content

Create 3D Object Scene Layer Package

Summary

Creates a scene layer package (.slpk file) from a multipatch feature layer input.

Usage

  • The output coordinate system should match the spatial reference of the web scene in which it will be displayed. If the intended display environment will be a global web scene, the output coordinate system must use GCS WGS 84.

  • The following are considerations for how z-coordinates should be defined in the 3D data being processed:

    • If the output scene layer package will have x,y coordinates in GCS WGS 84, the z-coordinate system can be defined using any ellipsoidal datum or EGM96 or EGM2008 through the Output Coordinate System parameter. If the z-coordinate system is undefined, the vertical units will be in meters.
    • If the output scene layer package will store x,y values in projected coordinates and the z-coordinate system is not defined, the vertical units will be the same as the x,y coordinates. For 3D features with undefined z-units that differ from the x,y units, consider using either the Adjust 3D Z tool to convert z-values to a matching linear unit or the Define Projection tool to define the correct z-datum.

  • The elevation of multipatch layers must be defined with absolute heights.

  • Only the fields designated as visible in the layer properties will be preserved in the scene layer package. If certain fields are not needed in the resulting scene layer, consider hiding the unwanted columns.

  • A scene layer package with a file size of less than 1 GB can be uploaded directly to ArcGIS Online or Portal for ArcGIS in a web browser. If it is larger than 1 GB, use the Share Package tool to upload it directly to ArcGIS Online or Portal for ArcGIS.

Syntax

Create3DObjectSceneLayerPackage_management (in_dataset, out_slpk, {out_coor_system}, transform_method, {texture_optimization})
ParameterExplanationData Type
in_dataset

The input multipatch feature layer.

Layer File; Feature Layer
out_slpk

The output scene layer package (.slpk).

File
out_coor_system
(Optional)

The spatial reference of the output scene layer package. It can be any projected coordinate system or GCS_WGS_1984. If a z-datum is defined, the linear unit must match that of the horizontal coordinate system. If the horizontal coordinate system is expressed in geographic coordinates, the z-datum must use meters. GCS_WGS_1984 is the default coordinate system. NAVD 88 is the default vertical coordinate system. The spatial reference can be specified by any of the following:

  • Specifying the path to a .prj file
  • Referencing a geodataset with the desired spatial reference
  • Using an arcpy.SpatialReference object

Spatial Reference
transform_method

The datum transformation method that will be used when the input layer's spatial reference uses a datum that differs from the output coordinate system. All transformations are bidirectional, regardless of the direction implied by their names. For example, NAD_1927_to_WGS_1984_3 will work correctly even if the datum conversion is from WGS 1984 to NAD 1927.

Note:

The ArcGIS Coordinate System data is required for vertical datum transformations between ellipsoidal and gravity-related and two gravity-related datums.

String
texture_optimization
(Optional)

Textures are optimized according to the target platform where the scene layer package is used.

Caution:

Optimizations that include ETC2 may take significant time to process. For fastest results use Desktop or None.

  • ALLAll texture formats including JPEG, DXT, and ETC2 for use in desktop, web, and mobile.
  • DESKTOPWindows, Linux, and Mac supported textures including JPEG and DXT. For use in ArcGIS Pro client on Windows and ArcGIS Runtime desktop clients on Windows, Linux, and Mac. This is the default.
  • MOBILEAndroid and iOS supported textures including JPEG and ETC2. For use in ArcGIS Runtime mobile applications.
  • NONEJPEG textures for use in desktop and web platforms.
String

Code sample

Create3DObjectSceneLayerPackage example (Python window)

The following script demonstrates how to use the Create3DObjectSceneLayerPackage tool in the Python window.

import arcpy
arcpy.management.Create3DObjectSceneLayerPackage(r'c:\temp\buildings.lyrx',
                                                 r'c:\temp\output.slpk',
                                                 arcpy.SpatialReference(4326), None, 'DESKTOP')

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics