创建建筑物场景图层包 (数据管理)

摘要

用于从建筑物图层输入创建场景图层包(.slpk 文件)。

使用情况

  • 要将 BIM 数据用作输入,必须首先将 BIM 数据作为建筑物图层添加到活动的全球或局部场景中。 可随后将建筑物图层或根据建筑物图层创建的图层文件 (.lyrx) 用作工具的输入。 有关使用 BIM 数据的详细信息,请参阅什么是 BIM 数据

  • 可将来源为地理数据库中要素类的建筑物图层用作输入。 可将 BIM 文件转地理数据库工具用于将 BIM 要素复制到地理数据库。 使用创建建筑物图层工具,根据 BIM 要素创建建筑物图层。

  • 不支持将单个类别图层或领域图层用作此工具的输入。 可将单个类别图层用作创建 3D 对象场景图层包工具的输入,但前提是必须先使用复制要素工具将其复制到地理数据库,并将其作为独立的多面体要素类添加到场景中。

  • 在建筑物图层上创作的过滤器将被写入场景图层包,并在支持读取过滤器的客户端中使用。

  • 有关建筑物场景图层的详细信息,请参阅建筑物场景图层

  • 输出坐标系应与显示 web 场景所使用的空间参考相匹配。 如果预期显示环境将为全球 web 场景,则请将 GCS WGS84 或 China Geodetic Coordinate System 2000 用作输出坐标系。 全球场景的垂直坐标系必须为椭圆体、EGM2008 大地水准面或 EGM96 大地水准面。

  • 在定义要处理的 3D 数据的 z 坐标时,请考虑以下事项:

    • 如果输出场景图层包将具有 x,y 坐标 (GCS WGS84),则可以使用任何 WGS84 坐标系作为基准面或者 EGM96 或 EGM2008 通过输出坐标系参数来定义 z 坐标系。 如果未定义 z 坐标系,则垂直单位将以米为单位。
    • 如果输出场景图层的投影坐标系中将具有 x,y 坐标,则只有在基准面与 x,y 坐标相匹配时才能定义 z 坐标系。 如果未指定 z 坐标系,则未定义的 z 坐标系的线性单位将与 x,y 坐标系匹配。

  • 可在浏览器中将场景图层包直接上传并发布到 ArcGIS OnlinePortal for ArcGIS。 您还可以使用共享包工具直接上传并发布至 ArcGIS OnlinePortal for ArcGIS

参数

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

输入建筑物图层或图层文件 (.lyrx)。

Building Layer; Layer File
输出场景图层包

输出场景图层包 (.slpk)。

File
输出坐标系
(可选)

输出场景图层包的坐标系。它可以是任意投影坐标系或自定义坐标系。支持的地理坐标系包括 WGS 1984 和 China Geodetic Coordinate System 2000。WGS 1984 和 EGM96 大地水准面分别是默认的水平和垂直坐标系。可通过以下任一方式指定坐标系:

  • 指定 .prj 文件的路径。
  • 引用具有所需坐标系的数据集。
  • 使用 arcpy.SpatialReference 对象。

Spatial Reference
地理变换
(可选)

此基准面变换方法适用于输入图层坐标系所使用的基准面不同于输出坐标系的情况。 所有变换均为双向,而不管其名称隐含的方向如何。 例如,即使基准变换为从 WGS84 到 NAD 1927,NAD_1927_to_WGS_1984_3 仍可正常运行。

注:

在椭圆体和重力相关的基准面以及两个与重力相关的基准面之间进行垂直基准面变换时,需要使用 ArcGIS 坐标系数据。

String
纹理优化
(可选)

指定根据使用场景图层包的目标平台优化的纹理。 桌面平台包括 WindowsLinuxMac 平台。 移动平台包括 iOSAndroid

警告:

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

  • 全部纹理格式将进行优化,可用于桌面、web 和移动平台。 纹理格式将为 JPEG、DXT 和 ETC2。
  • 桌面纹理格式将进行优化,可用于桌面和 web 平台。 纹理格式将为 JPEG 和 DXT。
  • 移动纹理格式将进行优化,可用于桌面和移动平台。 纹理格式将为 JPEG 和 ETC2。
  • 纹理格式将进行优化,可用于桌面平台。 纹理格式将为 JPEG。
String

arcpy.management.CreateBuildingSceneLayerPackage(in_dataset, out_slpk, {out_coor_system}, {transform_method}, {texture_optimization})
名称说明数据类型
in_dataset

输入建筑物图层或图层文件 (.lyrx)。

Building Layer; Layer File
out_slpk

输出场景图层包 (.slpk)。

File
out_coor_system
(可选)

输出场景图层包的坐标系。它可以是任意投影坐标系或自定义坐标系。支持的地理坐标系包括 WGS 1984 和 China Geodetic Coordinate System 2000。WGS 1984 和 EGM96 大地水准面分别是默认的水平和垂直坐标系。可通过以下任一方式指定坐标系:

  • 指定 .prj 文件的路径。
  • 引用具有所需坐标系的数据集。
  • 使用 arcpy.SpatialReference 对象。

Spatial Reference
transform_method
[transform_method,...]
(可选)

此基准面变换方法适用于输入图层坐标系所使用的基准面不同于输出坐标系的情况。 所有变换均为双向,而不管其名称隐含的方向如何。 例如,即使基准变换为从 WGS84 到 NAD 1927,NAD_1927_to_WGS_1984_3 仍可正常运行。

注:

在椭圆体和重力相关的基准面以及两个与重力相关的基准面之间进行垂直基准面变换时,需要使用 ArcGIS 坐标系数据。

String
texture_optimization
(可选)

指定根据使用场景图层包的目标平台优化的纹理。 桌面平台包括 WindowsLinuxMac 平台。 移动平台包括 iOSAndroid

警告:

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

  • ALL纹理格式将进行优化,可用于桌面、web 和移动平台。 纹理格式将为 JPEG、DXT 和 ETC2。
  • DESKTOP纹理格式将进行优化,可用于桌面和 web 平台。 纹理格式将为 JPEG 和 DXT。
  • MOBILE纹理格式将进行优化,可用于桌面和移动平台。 纹理格式将为 JPEG 和 ETC2。
  • NONE纹理格式将进行优化,可用于桌面平台。 纹理格式将为 JPEG。
String

代码示例

CreateBuildingSceneLayerPackage 示例(Python 窗口)

以下脚本演示了如何在 Python 窗口中使用 CreateBuildingSceneLayerPackage 函数。

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

环境

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

许可信息

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

相关主题