导入 3D 文件 (3D Analyst 工具)

汇总

将一个或多个 3D 模型导入到多面体要素类。

用法

通过将输出多面体存储到地理数据库中来保留 3D 模型的纹理。 Shapefile 不支持保留纹理。
如果生成的多面体要素的顶面朝向侧面，则启用 Y 轴向上参数，然后重新使用此工具调整方向。
GeoVRML 是唯一拥有已定义坐标系的格式。许多 3D 模型使用 XYZ 轴原点为 (0,0,0) 的局部坐标系生成。可以使用以下方法之一将此类要素地理配准到现实世界的坐标：
- 如果需要旋转和移动 3D 模型，考虑使用空间校正技术，以正确定位要素。
- 如果 3D 模型在给定坐标系下已正确定向，且只需移动到正确位置，考虑自定义坐标系属性以进行必要的平移。如果有定义每个模型质心在现实世界坐标中位置的点要素，考虑将这些点作为工具的输入以地理配准模型。
3D 文件中可能存在的点和线几何不会在输出多面体要素类中保留，因为多面体不支持它们。

注:

VRML 文件中不支持的几何类型包括立方体、圆锥、圆柱、拉伸、点集、球体和文本。

标注	说明	数据类型
输入文件	一个或多个 3D 模型或包含此类文件的文件夹，支持的格式包括 3D Studio Max (`.3ds`)、VRML 和 GeoVRML (`.wrl`)、OpenFlight (`.flt`)、COLLADA (`.dae`) 以及 Wavefront OBJ 模型 (*.obj)。	File; Folder
输出多面体要素类	从输入文件中创建的多面体。	Feature Class
每个要素一个根节点（可选）	指示是为每个文件生成一个要素，还是为文件中的每个根节点生成一个要素。此选项仅适用于 VRML 模型。选中—生成的输出将针对每个要素包含一个文件。这是默认设置。未选中—生成的输出将针对文件中的每个根节点包含一个要素。	Boolean
坐标系（可选）	输入数据的坐标系。对于大多数格式来说，这是未知的。只有 GeoVRML 格式存储其坐标系，其默认值将从列表中的第一个文件获得，除非在此处指定一个空间参考。	Spatial Reference
Y 轴向上（可选）	标识用于定义输入文件垂直方向的轴。选中—表示 y 轴向上。未选中—表示 z 轴向上。这是默认设置。	Boolean
文件后缀	要从输入文件夹导入的文件的文件扩展名。当至少指定一个文件夹作为输入时，此参数为必需项。所有受支持的文件—所有受支持的文件。这是默认设置。 *3D Studio Max (.3ds)—3D Studio Max VRML 或 GeoVRML (.wrl)—VRML 或 GeoVRML OpenFlight (.flt)—OpenFlight Collada (.dae)—Collada Wavefront OBJ 格式 (.obj)**—Wavefront OBJ 模型	String
放置点（可选）	点要素，其坐标定义了输入文件的实际位置。将根据存储在符号字段中的文件名，对每个输入文件与其对应的点进行匹配。应定义坐标系参数以与点的空间参考相匹配。	Feature Layer
符号字段（可选）	点要素中的字段，包含与各点相关联的 3D 文件的名称。	Field

arcpy.3d.Import3DFiles(in_files, out_featureClass, {root_per_feature}, {spatial_reference}, {y_is_up}, file_suffix, {in_featureClass}, {symbol_field})

名称	说明	数据类型
in_files [in_files,...]	一个或多个 3D 模型或包含此类文件的文件夹，支持的格式包括 3D Studio Max (`.3ds`)、VRML 和 GeoVRML (`.wrl`)、OpenFlight (`.flt`)、COLLADA (`.dae`) 以及 Wavefront OBJ 模型 (*.obj)。	File; Folder
out_featureClass	从输入文件中创建的多面体。	Feature Class
root_per_feature （可选）	指示是为每个文件生成一个要素，还是为文件中的每个根节点生成一个要素。此选项仅适用于 VRML 模型。 `ONE_FILE_ONE_FEATURE`—生成的输出将针对每个要素包含一个文件。这是默认设置。 `ONE_ROOT_ONE_FEATURE`—生成的输出将针对文件中的每个根节点包含一个要素。	Boolean
spatial_reference （可选）	输入数据的坐标系。对于大多数格式来说，这是未知的。只有 GeoVRML 格式存储其坐标系，其默认值将从列表中的第一个文件获得，除非在此处指定一个空间参考。	Spatial Reference
y_is_up （可选）	标识用于定义输入文件垂直方向的轴。 `Y_IS_UP`—表示 y 轴向上。 `Z_IS_UP`—表示 z 轴向上。这是默认设置。	Boolean
file_suffix	要从输入文件夹导入的文件的文件扩展名。当至少指定一个文件夹作为输入时，此参数为必需项。 `*`—所有受支持的文件。这是默认设置。 `3DS`—3D Studio Max `WRL`—VRML 或 GeoVRML `FLT`—OpenFlight `DAE`—Collada `OBJ`—Wavefront OBJ 模型	String
in_featureClass （可选）	点要素，其坐标定义了输入文件的实际位置。将根据存储在符号字段中的文件名，对每个输入文件与其对应的点进行匹配。应定义坐标系参数以与点的空间参考相匹配。	Feature Layer
symbol_field （可选）	点要素中的字段，包含与各点相关联的 3D 文件的名称。	Field

代码示例

Import3DFiles 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具：

arcpy.env.workspace = "C:/data"
arcpy.ddd.Import3DFiles("AddisSheraton.skp", "Test.gdb/AddisSheraton", False, "", False)

Import3DFiles 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具：

'''****************************************************************************
Name: Import3DFiles Example
Description: This script demonstrates how to use the
             ListFiles method to collect all OpenFlight (*.flt) models in a
             workspace as input for the Import3DFiles tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
OpenFlightList = arcpy.ListFiles("*.flt")
CS = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
outputFC = "Test.gdb/OpenFlight_Models"

if len(OpenFlightList) > 0:
    # Run Import3DFiles
    arcpy.ddd.Import3DFiles(OpenFlightList, outputFC, False, CS, False)
else:
    # Returned if there are no flt files in the target workspace
    print("There are no OpenFlight files in the " + env.workspace + " directory.")

环境

当前工作空间, 输出坐标系, 输出 XY 值域, 输出 Z 值域, 自动提交, 输出配置关键字

许可信息

基本: 是
标准: 是
高级: 是

导入 3D 文件 (3D Analyst 工具)

汇总

用法

注:

参数

环境

许可信息

相关主题