帮助

多面体转 Collada

摘要

将一个或多个多面体要素转换为 COLLADA (.dae) 文件及其引用的纹理图像文件的集合并将此集合存储在输出文件夹中。输入可以是图层或要素类。

用法

  • COLLADA 文件是 3D 对象的 XML 表示，可以引用其他用作叠加在 3D 几何上的纹理的图像文件。这表示，将多面体要素导出到 COLLADA 会创建若干文件 - 一个包含 3D 对象的 XML 表示的 .dae 文件以及一个或多个包含纹理的图像文件（例如 .jpg 或 .png 文件）。

  • 此工具为其导出的每个多面体要素创建一个 COLLADA 表示。此工具使用每个要素的一个字段值（默认情况下是“对象 ID”字段值）定义输出文件名。这样更易于识别哪个要素导出到哪个 COLLADA 文件，同时，在将多个要素导出到同一个目录中时，也提供了定义唯一文件名的方法。纹理文件与 COLLADA 文件存储在同一个目录中。为了将导出文件的总体大小降至最低，可以将用于多个 COLLADA 文件的纹理（如重复使用的砖块或窗户纹理）仅导出一次，然后由适用的 DAE 文件进行引用。

  • 此工具自动覆盖具有相同文件名的现有 COLLADA 文件。如果发生覆盖文件的情况，将显示警告消息，提示导出过程中新文件覆盖了哪些文件。对于任何无法导出的要素，还将生成 GP 消息，例如，输出位置为只读，或者磁盘已满。

  • 要确保为所有导出的多面体要素创建新的 COLLADA 文件，请将目标目录设置为空文件夹或新文件夹，并选择对每个要素唯一的文件名字段。导出具有相同属性值的两个要素会造成第二个导出的要素覆盖第一个导出的要素的 COLLADA 文件。

  • 采用将多面体要素导出到 COLLADA 并在 ArcGIS 之外进行更改这种方式反复更新多面体要素时，请每次都将要素导出到相同位置。这样只需在磁盘上为该要素保存一个文件，此文件表示 3D 对象的最新状态。

  • 如果导出的多面体（如存储在 UTM 区域中的建筑物）在投影坐标系中，则还将在输出文件夹中创建包含坐标（如 WGS84）的 KML 文件。请注意，此过程不会使用基准面变换，如果使用基准面变换，则在查看 KML 时可能会导致定位偏差。

语法

MultipatchToCollada_conversion (in_features, output_folder, {prepend_source}, {field_name})
参数说明数据类型
in_features

要导出的多面体要素。

Feature Layer
output_folder

放置输出 COLLADA 文件和纹理图像文件的目标文件夹。

Folder
prepend_source
(可选)

将源要素图层的名称添加为输出 COLLADA 文件的文件名的前缀。

  • PREPEND_SOURCE_NAME —添加文件名前缀。
  • PREPEND_NONE —不添加文件名前缀。这是默认设置。
Boolean
field_name
(可选)

用作每个导出的要素的输出 COLLADA 文件名的要素属性。如果未指定字段，则使用要素的“对象 ID”。

Field

代码实例

多面体转 COLLADA (MultipatchToCollada) 示例 1（Python 窗口）

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

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.MultipatchToCollada_conversion("Sample.gdb/Buildings", "C:/COLLADA", 
                                   "PREPEND_SOURCE_NAME", "BldName")
多面体转 COLLADA (MultipatchToCollada) 示例 2（独立脚本）

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

'''*********************************************************************
Name: Convert Multipatch To Collada
Description: Converts multipatch features in an input workspace 
             to a Collada model.
*********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

# Script variables
inWorkspace = arcpy.GetParameterAsText(0)

try:
    # Set environment settings
    env.workspace = inWorkspace
    # Create list of feature classes in workspace
    fcList = arcpy.ListFeatureClasses()
    # Determine if the list contained any feature classes
    if fcList:
        # Iterate through each feature class
        for fc in fcList:
            # Describe the feature class
            desc = arcpy.Describe(fc)
            # Determine if feature class is a multipatch
            if desc.shapeType is 'MultiPatch':
               # Ensure unique name for output folder
               outDir = arcpy.CreateUniqueName('collada_dir')
               # Specify that collada file is prefixed by source name
               prepend = 'PREPEND_SOURCE_NAME'
               # Specify the feature attribute used to name Collada files
               fldName = 'OID'
               #Execute MultipatchToCollada
               arcpy.MultipatchToCollada(fc, outDir, prepend, fldName)
    else:
        print 'There are no feature classes in {0}.'.format(inWorkspace)
        
except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

环境

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

许可信息

  • ArcGIS for Desktop Basic: 是
  • ArcGIS for Desktop Standard: 是
  • ArcGIS for Desktop Advanced: 是

相关主题

有关此主题的反馈?